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PREFACE 


This manual describes the SPL/32 spooling system for Perkin-Elmer 
32-bit computer systems. This information is useful to the 
system administrator and applications programmer for the 
initialization, administration, and internal function of the 
SPL/32 spooling process. The commands section may prove useful 
to the system operator. Chapter 1 presents the spooling concept; 
summarizes the basic components of SPL/32, outlines the hardware 
and software required to run SPL/32, and details the 
initialization procedures for starting the spooling process. 
Chapter 2 explains input spooling and related commands. Chapter 
3 explains the function of the spool queue, spool files, and 
related commands. Chapter 4 presents output spooling and its 
associated commands. Chapter 5 presents the concept of task 
interfacing, the function of the uniform spooler control 
interface (USCI), and the concept of capabilities based on levels 
of authority and associated commands. Chapter 6 details each 
SPL/32 command. Complete format and optional parameter lists are 
presented for each command. Appendix A summarizes SPL/32 
commands. Appendix B presents messages in a tabular format. 
Appendix C presents a comparison of SPL/32 commands and existing 
spooler commands in a tabular format. Appendix D presents 
message handling internals. Appendix E presents the SPL/32 
commands in preparsed format. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
INTRODUCTION TO SPL/32 


1.1. INTRODUCTION 

The SPL/32 Spooler is a component of the 32-bit operating system 
and is designed to improve the handling of input/output (1/0) 
processes to low speed devices. The spooler also. provides 
advanced capabilities for configuring and dynamically altering 


the output spooling environment. SPL/32 is available to users of 
the following Perkin-Elmer processors: 


@e Memory access controller processors 


- Model 7/32 
- Model 8/32 


- Model 3220 
e Memory address translator processors 


- Model 3210 
- Model 3230 
~ Model 3240 


- Model 3250 


Spooling (simultaneous peripheral operations online) is a process 


in which I/O to low speed devices, such as card readers, 
printers, and card punches, is sent directly to intermediate high 
speed devices (disks). This process releases the central 


processing unit (CPU) from having to execute at the speed at 
which low speed I/0 devices can supply or receive information, 
resulting in improved system throughput. 


48-056 FOO ROO 1-1 


The SPL/32 Spooler provides three major advantages to a user: 


ie Increased Utilization of I/O Devices 


I/O devices that are dedicated to the execution of ae single 
process are frequently idle at some point during the 
execution of that process. Spooling disassociates the I/0 
device function from the program execution function of a 
process, thereby releasing the I/O device for use by some 
other process. 


2. Increased System Performance 


On all spooled systems, CPU input and output operations are 
performed to disk, a high speed I/O device, more compatible 
with the CPU's speed in I/O operations. Consequently, the 
CPU spends less time waiting. In addition, disk 1/0 
operations can be blocked, thereby reducing the number of 1/0 
operations performed per process executed. 


3. Reduced Device Contention 
The use of a particular output device, such as a line 
printer, is disassociated with the actual execution of a 


program. This enables many programs to generate output 
ultimately destined for the same output device without that 
device being dedicated to a particular task. The spooler 
directs program output to the appropriate device as it 
becomes available. 
In addition to these generalized benefits, the SPL/32 Spooler 
provides commands that enable the administrator of a system to 
tailor the spooler to best suit the requirements of that 
particular system. These commands enable: 
e the use of an unlimited number of output devices, 
e@ the ability to add or drop devices dynamically, 


e the ability to control output devices from designated 
terminals anywhere within the spooling environment, 


e the use of special forms-handling capabilities, 
e the use of security mechanisms, 


e the ability to manipulate the position of files on the print 
queue and also alter the output requirements of these files, 


e the ability to uniquely identify output files, and 


e the ability to stop devices in the spooling environment, or 
the spooler itself, in an orderly manner. 
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1.2 COMPONENTS OF THE SPOOLING PROCESS 


SPL/32 is composed of a number of interrelated components”) that 
together make up the spooling process. The following sections 
identify and briefly describe the basic components of the SPL/32 
Spooler. 


1.2.1. Input Spooling 


Input spooling is a process in which a batch stream of cards is 
copied to a disk file prior to being accessed by the CPU for 
processing. The user specifies the name of the disk file. Once 
the card deck has been copied to disk, it can then be accessed, 
submitted for processing, or retained for future use. 


1.2.2 Output Spooling 


Output spooling is a process in which program output destined for 
a physical output device, such as a printer or card punch, is 
initially copied to a disk file, known as a spool file. Once a 
spool file is created, the output of that spool file is 
controlled by the spooler, which directs the file to a specified 
or default (if not otherwise specified) physical output device. 


1.2.3 The Spool Queue 


The spool queue is a disk file maintained by the spooler that 
contains an entry for each file destined for output via the 
spooler. Each entry contains information relative to the 
originator and output requirements. 


1.2.4 The Pseudo Device 


A pseudo device establishes a correlation between a user and a 
physical output device. Output is assigned to pseudo devices 
rather than directly to physical devices. The pseudo devices are 
logically associated with one or more physical output devices. 
The spooler is responsible for directing output assigned to a 
pseudo device to the appropriate physical device. 


1.2.5 The Spool File 

A spool file is a disk file that is allocated by the spooler when 
an assignment to a pseudo device is made via an ASSIGN or 
SPOOLFILE command. I/O operations are performed using spool 
files. 


1.2.6 The Uniform Spooler Control Interface (USCI) 


The USCI serves as the software interface between the spooler and 
all devices/tasks that communicate with the spooler. 
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1.3 REVIEW 


Figure 1-1 is presented to show the relationships of the six 
basic components of the Perkin-Elmer Spooler (SPL/32). 
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Figure 1-1 The Components of SPL/32 
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1.4 COMPONENTS OF SPOOLER CONTROL 


The Perkin-Elmer Spooler provides a means of designating certain 
tasks within the spooling environment as tasks that can 


communicate with, and thus control, the use of the’ spooler. In 
addition, these tasks can be assigned levels of authority that 
further define the task's scope of control. The following 


sections introduce this concept. 


1.4.1 Control and Subcontrol Tasks 


Two types of tasks can communicate directly with the spooler: 


e Control tasks 


e Subcontrol tasks 


Control tasks supervise spool devices via the use of spooler 
commands. These tasks are capable of having a direct 
request/direct response relationship with the spooler and are 
also designed to receive messages pertaining to the status of 
devices under their control. Control tasks can also grant’ tasks 
within their environment the privilege of issuing spooler 
commands directly to the spooler. These tasks are known as 
subcontrol tasks. Responses to commands issued from a subcontrol 
task can be selectively routed: 


e they can be directed back to the originating subcontrol tasks, 
Or 

e they can be directed to the control task monitoring the 
originating subcontrol task. 


This selective routing can change from request to request. 


1.4.2 Levels of Authorization 


The availability of the spooler commands used by control and 
subcontrol tasks to alter or control the spooling environment is 
limited through the use of levels of authorization. Each command 
has associated with it an authorization level identified via an 
authorization idenfifier (AID). This AID must accompany the 
command before the spoole: will execute the command. The three 
levels of authorization are: 


e Primary (highest) 
@ Secondary (selective) 


e User (lowest) 
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The authorization level 


of a command 
ability to 


reflects the command's 
affect the spooling environment. Commands with 
primary authorization have the ability to 
spooling environment. 


alter the global 
Commands with secondary authorization have 
the ability to alter the environment of a logically defined group 
of 


tasks or terminals within the spooling environment. Commands 
with user authorization have the ability to alter the status of 
files placed on the spool queue by that user. 
Figure 1-2 is presented to show the relationship between control 
and subcontrol tasks. 
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Figure 1-2 Control and Subcontrol Tasks Communications Flow 
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1.5 REQUIREMENTS FOR SPL/32 


The following sections detail the hardware, memory, and software 
required to run SPL/32. 


1.5.1 Hardware 

The following minimum hardware requirements must be met in order 
to run SPL/32. 

@ One disk volume to store spool files and the spool queue. 


@® One terminal device to receive messages and enter SPL/32 
commands. 


e One card reader if input spooling is required. 

e One printer for output of spooled print files. 

@ One card punch for output of spooled punch files. 

SPL/32 will support peripheral devices listed in the Perkin-Elmer 
OS/32 System Generation (Sysgen) Reference Manual. 

1.5.2 Memory Requirements 


SPL/32 memory requirements are approximately 75.00kb plus: 


@ 32.50kb for each output device specified, and 

e 25.00kb for each input device specified. 

If no monitor control task is used (such as MTM), an additional 
35kb are required for the SPL/32 monitor (SPLC). 

1.5.3 Software Requirements 

SPL/32 will run on systems operating in an OS/32 Release 6.2 or 
higher environment with vertical forms control (VFC) = and 
supervisor call (SVC) intercept options as required features. 


SPL/32 and the original OS/32 spooler are mutually exclusive 


software products. Only one spooler can be active on a machine 
at a given time. The spooler to be used is selected at system 
generation (sysgen) time. Refer to the System Generation/32 


(SYSGEN/32) Reference Manual for details. 
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1.6 INITIALIZING SPL/32 


The following sections outline the procedures’ involved in 
preparing and starting SPL/32. 

1.6.1 Loading SPL/32 

SPL/32 is provided in object format with the 0OS/32 operating 


system package. SPL/32 must be built as a universal task and 
must be loaded with the task identifier (taskid).SPLR. 


Format: 
LOAD .SPLR,SPL32,segsize increment 


Parameters: 


SPILR is the name of the taskid for the spooler. 

SPL32 is the name of the load file on disk. 

segsize is a decimal number’ in kilobytes specifying 

increment the amount of get storage area in the task's 
impure memory segment. If specified, this 


value overrides the GET and EXPAND values used 
when the task is linked. 


Example: 
LOAD .SPLR,SPOOLER. TSK, 20 


where 20 indicates that the spooler should be loaded into a 
larger segment. Complete information regarding the LOAD command 
is presented in the Perkin-Elmer OS/32 Operator Reference Manual. 


SPL/32 may also be loaded using an SVC6 load-function option. 


For information regarding this procedure, see the Perkin-Elmer 
OS/32 Supervisor Call (SVC) Reference Manual. 
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1.6.2 Linking SPL/32 


The following sequence of LINK commands builds the spooler task 
as an image load module without overlays. 


ESTABLISH TASK 

OPTION, WORK=X4000,SYS=XFFFFF , TEQSAVE=NO, UNIV, COM,CON,ACP, 
LU=254, INTERCEPT 

INCLUDE SPL 

MAP PR: ,ADDR,ALPHA 

LIB PNEW1LX 

LIB PASRTL 

BUILD SPL 

END 


For LINK instructions to build the spooler task with overlays, 
see the packaging document. 


1.6.3 Starting the Spooler 
Creating the desired initial spooler environment is accomplished 
through the use of the START cormand. 


Format: 


START [,COMMAND = fd] 


Parameters: 
fd specifies a file descriptor for the location 
of the commands to configure the spooling 
environment. 


Functional Details: 


These commands may be in a disk file, card deck, magnetic tape, 
or may be entered from an interactive device. Any combination of 
valid SPL/32 commands (as listed in Chapter 6) may be used in the 
command file. | 


48-056 FOO ROO sage. 


Examples: 


START, COMMAND = M300: PARAM.DI.K/118 


File PARAM.DLK in account 118 on volume M300: contains the 
SPL/32 startup parameters. 


START, COMMAND = CRD: 


The card deck in card reader CRD: contains the SPL/32 
startup parameters. 


START, COMMAND = MAG1: 


The tape mounted on tape drive MAGL: contains the SPL/32 
startup parameters. 


START, COMMAND = CON: 


If the optional parameter [COMMAND = fd] is not included in 
the START command, the system console becomes, by default, 
the device where the initial SPL/32 commands for configuring 
the spooler environment will be entered. 


1.6.3.1 Creating a START Command File 


A START command file is simply a sequential text file that 
contains spooler commands. The commands in Chapter 6 are those 
available for use in the START command file. Commands must be 
presented one per line with the correct syntax. The end of a 
START command file is signified by the following for the media 
listed: 


H H END ID H 
ee ete BE eae Oe Se Ne 5 eres Hp oem Yer ue te ON pe ry ay EE RNR ENE eee) Oe ee Me ERE ee 
: Cards /* on the final card | 
| Disk file ! end of file (EOF) condition, or /* | 
! Mag tape EOF mark, or /* ! 
3 | : 


Interactive device {; Two consecutive carriage returns, or /* 


cs Se ee RD REO OT ER CR RE RD Oe OE ESE aR eva RO On ONO ED eR OD ~ 
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A sample START command file follows: 


SPVOLUME INCLUDE M300, M301, M302 


QUEUE M30 1.: SPLQUEUE .NEW 

BLOCK 2/3 

PRIORITY 220 

INPUT INCLUDE CRD1:, CRD2:, DRD3: 

CREATE pdl:, pd2:, pd3: 

GLOBAL pdl: 

ATTACH PDEVICE = pdl: RDEVICE = prtl: 

ATTACH PDEVICE = pd2: RDEVICE = prt2:, prtd: 
ATTACH PDEVICE = pd3: RDEVICE = prt9: 

GROUP PDEVICE = pdl:, INCLUDE CRT1:, CRT2:, CRT3: 
GROUP PDEVICE = pd2:, INCLUDE CRT7:, CRT8:, CRT9: 
BANNER prtl:, SINGLE 

BANNER prt9:, NONE 

BANNER prt2:, DOUBLE 

FORM INCLUDE REPORTS, CHECKS, TIMECARD 

/* 


By passing the name of the example file in a START command, the 
spooler environment will be configured according to the commands 
present in the command file. 


Readers should familiarize themselves with the function of the 
various spooler commands before creating the START command file. 


It is also possible to start the spooler without specifying a 


START command file. In this case, the spooling environment will 
be established using the default conditions for each 
environmental parameter. The spooling environment can then be 


altered dynamically as the need arises, without interrupting 
spooler performance. 


1.6.4 SPL/32 System Console Interface 


There are two general conventions available for interfacing with 
SPL/32 at the system console. 


The initial procedure involves selecting the SPL/32 task as the 
current task at the system console before entering any spooler 
commands. Then spooler commands can be entered as long as_ they 
are preceded by a SEND instruction. 


Example: 


*TASK .SPL 
*SEND INTERROGATE QUEUE ? any SPL/32 command 
*SEND CTASK 
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The second convention involves prefixing each SPL/32 command with 
the .SPL prefix or the .MIM prefix, depending upon which monitor 
control task is being used. Initially, .SPL should be used. 


Example: 
*,.SPL INTERROGATE QUEUE 


-Wnen the monitor task for the spooler is to be MTM, the following 
command sequence establishes MTM as the primary control task. 


Example: 


*LO .MTM,MTM 
*.SPL CTASK INCLUDE .MTM 
*.SPL PRIMARY .MTM/CON 


Each subsequent SPL/32 command must be preceded by the .MTM 
prefix. 


Example: 
*.MTM INTERROGATE QUEUE 


1.6.5 Ending the Spooler Task 


The spooler can be stopped via the END command. This command 
provides the option of an immediate or delayed stop. 


Examples: 


END IMMEDIATE 


All spooler functions cease. All pseudo devices and physical 
devices are removed. 


END DELAYED 
All spooler functions cease after the currently printing 


spool files are output. New assignments to the spooler are 
rejected. Section 6.22 further defines the END command. 
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CHAPTER 2 
INPUT SPOOLING 


2.1 INTRODUCTION 


The SPL/32 input spooling feature provides facilities for copying 
a batch stream of cards such as source programs, operator 
commands, command substitution system (CSS) files, or other data 
to disk files for subsequent processing. This procedure is 
performed without user task intervention. Each card deck can be 
spooled to a user-specified file descriptor (fd), and the file 
can be submitted to the Perkin-Elmer Multi-Terminal Monitor (MTM) 
for batch processing. The following sections describe how the 
input spooling feature is established, functions, and is stopped. 


2.2 ESTABLISHING INPUT SPOOLING 


The input spooler task is a non-resident task that is implicitly 
loaded into memory when a card reader is added to the spooler 
environment. There is one input task for each card reader 
inc Luded. 


Card readers are designated as spooled devices via the INCLUDE 
parameter of the INPUT command. See Section 6.15. Spooled card 
readers are exclusively assigned to the spooler function and 
cannot be used by any other task unless it is through the 
spooler. 

2.3 INPUT SPOOLING CONTROL STATEMENTS 

fach batch of cards to be spooled to disk must be preceded by a 
control card statement. This statement specifies the fd to which 
the input data is to be spooled. SPL/32 provides two such 
control statements: 


e /@INPUT 


e /@SUBMIT 
2.3.1 The /@INPUT Control Statement 


The. /@INPUT control statement is used to copy a card file to a 
specified fd on disk. 
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Format: 
LJBINPUT fd[,DELETE] 


Parameters: 


fd specifies the file descriptor of the disk file 
in the form voln:filename.ext/acctno. An 
index file with a logical record length of 80 
bytes and a blocksize of one 256 byte sector 
each for both data and index blocks is 
allocated with name fd. 


DELETE if the file currently exists, it is deleted 
and reallocated when this parameter is 
specified. 


Functional Details: 


The default blocksize for data and index blocks can be changed 
via the SPL/32 BLOCK command. (See Section 6.4.) The blocksizes 
used by the /@INPUT command will be the default values in effect 
at the time the card reader is included in the spooler 
environment. 


If a file currently exists and the DELETE option is omitted, the 
spooler will issue the following error message: 


SVC7 ERROR VOLN: FILENAME .EXT 


If a control statement card is syntactically incorrect, SPL/32 
issues one of the following messages based on the nature of the 
error: 


MISSING PARAMETER: text 
INVALID PARAMETER: text 
INVALID FILENAME: text 
INVALID KEYWORD: text 
INVALID SEPARATOR: text 
INVALID CONTROL CARD: text 
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The deck of cards containing the problem is read (the information 
is not copied to disk) until a new control statement is read. 
This process allows stacked input to be processed even if an 
intervening card deck contains an error. If a card reader 
returns a status xX'AO' before an ending control statement is 
read, the spooler retries the read at timed intervals until more 
cards are placed in the reader. All other spooler functions, 
such as printing and punching to or reading from other’ spool 
devices, continue. If the volume name is omitted from the fd in 
a /@INPUT control statement, the file is allocated on one of the 
spool volumes specified in the SPVOLUME command. 


2.3.2 The /@SUBMIT Control Statement 


The /@SUBMIT control statement is used in an MTM environment’ to 


copy a card batch to a specified fd and to submit the fd to MIM 
for batch processing. 


Format: 
J@SUBMIT fd[ ,DELETE] 


Parameters: 


fd specifies the file descriptor. An index file 
with a logical record length of 80 bytes and 
a blocksize of one 256 byte sector each for 
both data and index blocks is allocated with 


name fd. 
DELETE if the file currently exists, it is deleted 
and reallocated when this parameter is 


specified. 
Functional Details: 


The default blocksize for data and index blocks can be changed 
via the SPL/32 BLOCK command. (See Section 6.4.) The blocksizes 
used by the /@INPUT command will be the default values in effect 

when the card reader is included in the spooling environment. 


If a file currently exists and the DELETE option is omitted, the ; 


spooler will issue the following error message: 


SVC7 ERROR VOIN: FILENAME .EXT 
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If a control statement card is syntactically incorrect, SPL/32 
issues one of the following messages based on the nature of the 
error: 


MISSING PARAMETER: text 
INVALID PARAMETER: text 
INVALID FILENAME: text 
INVALID KEYWORD: text 
INVALID SEPARATOR: text 
INVALID CONTROL CARD: text 


The file containing the error is read (the information is not 
copied to disk) until a new control statement is read. The 
process of reading the remaining card files allows stacked input 
to be spooled even if an intervening card file contains an error. 


If a card reader returns a status X'AO' before an ending’ control 
statement is read, the spooler assumes that some of the card deck 
is missing and retries the read at timed intervals until more 
cards are placed in the reader. All other spooling functions, 
such as printing and punching to or reading from spooled devices, 
continue. 


If the volume name is omitted from the fd in a /@SUBMIT control 
statement, the file is allocated on one of the spool volumes 
specified in the SPVOLUME command. 


2.3.3 Ending Input Spooling of a Card File 


The following control statement denotes the end of an input’ card 
file: 


/@ 


These characters must be entered in columns 1 and 2 with blanks 
in all remaining columns. This control statement should be 
located on the last card in the file. 


When a number of card files are consecutively stacked in a single 
card reader, the halt control statement notifies the spooler of 
the end of one card file. The following card must contain the 
/@®INPUT or /@SUBMIT control statement for the next card file to 
begin spooling. If the halt control statement is omitted, a new 
file will be allocated for the next card file, spooling will 
continue for that file, and the following message will be sent to 
the monitor control task: 


MISSING CONTROL CARD: FILEVOLN: FILENAME .EXT 
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Figure 2-1 details the proper sequences for single and stacked 
card files. 
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SINGLE CARD FILE STACKED CARD FILES 


END CONTROL 
CARD END CONTROL CARD 


/@ FILE 2 
INPUT CONTROL INPUT CONTROL CARD 
/@ SUBMIT fd CARD FILE 2 
/® SUBMIT fd END CONTROL CARD 
(= Fined 


/@ SUBMIT fd 


INPUT CONTROL CARD 
FILE 1 


Figure 2-1 Control Statement Sequences For Single and 
Stacked Card Files 


2.4 REMOVING INPUT SPOOLING DEVICES 


Card readers are removed from the spooling environment via _ the 
REMOVE parameter of the INPUT command. SPL/32 allocates one 
input task for each card reader in the spooling environment. 
When a card reader is removed from the spooling environment, its 
associated input task is cancelled. 


48-056 FOO ROO 275 


CHAPTER 3 
THE SPOOL FILE AND THE SPOOL QUEUE 


3.1 INTRODUCTION 


A spool file is a disk file created by SPL/32 to receive output 
data that is subsequently to be sent to a physical output device. 
Spool files are allocated by the spooler in response to 
assignments to pseudo devices via an ASSIGN or SPOOLFILE command. 


The spool queue is a disk file that contains status information 
regarding each file to be output via the spooler. These may be 
spool files (files allocated by the spooler) or user files 
(already existent files) temporarily assigned to the spooler for 
output via a PRINT, PUNCH, or CHANGE - command. The following 
sections explain the structure, function, and use of these two 
components of SPL/32. 


3.2 THE SPOOL FILE 


In a spooled environment, output data assigned to a pseudo device 
via an ASSIGN or SPOOLFILE command is written to a disk file 
called a spool file. Each time an assignment is made to a pseudo 
device, OS/32 intercepts the supervisor call 7 (SVC7) generated 
and routes it to SPL/32. SPL/32 translates the assign and 
allocates a spool file. Spool files are allocated on multiple 
spool volumes (if present) in a rotating fashion so that no 
volume receives a disproportionate number of spool files. ‘The 
index and data blocksize of spool files can be specified using 
the BLOCK command. The default value for both data and index 
blocksize is one 256 byte sector each. When changing the default 
blocksize, the value specified cannot exceed the values specified 
at system generation (sysgen) time. The record length of spool 
files is determined by the spooler when an assignment is made to 
a pseudo device, the spooler reads the device attributes of the 
physical device associated with the pseudo device. Spool files 
allocated as a result of the assignment to that pseudo device 
have the record length of the physical device. If multiple 
physical devices are associated with a single pseudo device, the 
record length of the device with the largest record length is 
used. Therefore, similar output devices should be grouped under 
one pseudo device. If a pseudo device has not been associated 
with any physical devices, the spooler assigns a default record 
length of 137 bytes. 
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3.2.1 Naming Spool Files 


SPL/32 uses the following format when naming spool files: 


~ 3622 


BYTES: 0 1 


Fields: 


TASKNAME 


LU 


EXT 


Example: 


@TESTOO2 


- 4 5 7 8 — 10 +11 - 13 


is the l-character at sign that precedes’ the 
filename and identifies the file as a spool 
file. 


is the first four characters of the taskname 
on whose behalf the assignment is being made. 


is a 3-digit decimal number representing the 
logical unit being assigned. 


is a 3-character extension used to distinguish 
between spool files if naming conflicts arise 
in the first eight characters of the spool 
file name. This field can contain any 
combination of the letters A through Z and the 
hexadecimal numbers O through F. 


is a l- to 3-digit decimal number. specifying 
the user account from which the assignment 
originated. 


-000/119 


The preceding example designates a spool file with the following 


information: 


@e assigned from a task called TESTRUN, 


e assigned lu 002, 


e has the extension 000, and 


e originated from account number 119. 
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When the lu assigned to a spool file is closed, the SVC7 is 
intercepted by OS/32 and routed to the spooler, which places the 
spool file name on the spool queue. Spool files are placed on 
the queue in order of task priority and are subsequently output 
in that order depending on the availability of the required 
output device. Figure 3-1 illustrates the steps followed in the 
evolution of a spool file. 
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a LAAT 

USER/TASK 

ASSIGNS TO SPOOL FILES ARE 

A PSEUDO OUTPUT ACCORDING 

DEVICE TO INFORMATION 
CONTAINED IN 
THE SPOOL QUEUE, 
ON A TASK ; 

(= PRIORITY BASIS. 

OS/32 

INTERCEPTS THE 

SVC7 AND ROUTES 

TO SPL/32. 


SPL/32 ALLOCATES A 
SPOOL FILE ON DISK. 


DATA IS WRITTEN 
TO THE SPOOL FILE 
VIA THE USER TASK. 


SPL/32 ADDS FILE TO 
THE SPOOL QUEUE. 


SPL/32 


LOGICAL UNIT ASSIGNED TO OS/32 INTERCEPTS THE 
THE SPOOL FILE IS CLOSED. SVC7 CLOSE AND 
SVC7 IS ISSUED. ROUTES IT TO SPL/32. 


Figure 3-1 Evolution of a Spool File 
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3.3 THE SPOOL QUEUE 


The spool queue is a disk file that contains an entry for cach 
spool file on the system. Each entry contains origin and output 
requirements for each spool file. 


3.3.1 Creating the Spool Queue 


The spool queue is created at SPL/32 startup time in one of two 
ways: 


1. The spool queue can be explicitly created, named, and 
allocated on a specified disk volume using the QUEUE command. 


Example: 
QUEUE M67B:SPLQUEUE .NEW 


SPLQUEUE.NEW is allocated as the spool queue on disk volume 
M67B. If the disk volume is omitted, the spool queue is 
allocated on the first volume specified in a _ previous 
SPVOLUME command, or on the default system volume if no 
SPVOLUME command was previously entered. If no spool volumes 
were previously specified, and the system volume cannot be 
written to, the TEMP volume must be available or else the 
spool queue cannot be allocated. 


2. The spool queue is implicitly created by the spooler if the 
QUEUE command is not’ used. The default spool queue, 
SPL32.QUE, is allocated on the first volume specified in a 
previous SPVOLUME command or, by default, on the system 
volume if no previous SPVOLUME command was’ entered. If no 
spool volumes were previously specified, and the system 
volume cannot be written to, the TEMP volume must’ be 
available or else the spool queue cannot be allocated. 


The spool queue is a dynamic file with a default block size of 1 
and a record length of 136. 


3.3.2 Displaying the Spool Queue File Name 
The spool queue currently in use can be determined by entering 


the QUEUE command without parameters. The following example 
represents this with a resultant display. 
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Example: 


* QUEUE 
* 


* QUEUEFILE = M301:SPL32.QUE/0 


3.3.3 Respecifying the Spool Queue 


If a system failure occurs while the spooler is active or _ the 
spooler task is cancelled, spool file entries listed on the spool 
queue at the time of the failure will be held. After the system 
is restarted and the spool queue name is’ specified, spooling 
resumes with the file that was being output at the time of the 


interruption. If no file was being output, spooling begins with 
the next entry on the queue. If the default spool queue, 
SPL32.QUE, was in use prior to the failure, it is not necessary 
to respecify the spool queue because the spooler will 


automatically reassign the default spool queue. 


3.3.4 Respecifying the Spool Queue While the Spooler is Active 


SPL/32 allows the user to respecify the spool queue while the 
spooler is active. This is accomplished via the QUEUE command. 
When a new spool queue is specified, those entries on the old 
queue that were being output at the time of the interruption are 
copied by SPL/32 into the new spool queue. Spooling then resumes 
with these entries. 


3.3.5 Interrogating the Spool Queue 

Entries on the spool queue and the status and configuration of 
the spooling environment can be displayed using the INTERROGATE 
command. This information can be selectively displayed according © 
to the type of information desired. The following five sections 
detail the optional displays available. 

3.3.5.1 Displaying Entries In the Spool Queue 

The QUEUE parameter of the INTERROGATE command displays all 


entries in the spool queue relative to the user's authorization 
Level. 


Example: 


INTERROGATE QUEUE 
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. Resultant Display: 


' PSEUDO 


DEVICE FILE NAME FORMNAME COP PRI OPTIONS 
PD1: M67B: @COPY003 .000/118 STD 10 128 H I D 
PD2: M300: @TESTOOS5 .000/119 CHECKS 95 129 H I 
PD3: M300: @TESTOO04 .001/120 STD 1 130 R I D 
PD4: M67B:TEST.PRT/100 FORMA 12 128 R I 


The letters (or blanks) displayed in the options columns 
represent options specified in the PRINT/PUNCH request when each 
file was placed on the queue. These option symbols (or _ blanks) 
are explained in Table 3-1. 


“Note that the NOIMAGE, NODELETE, and NOVFC options are 


eee 


represented in the display by blanks in columns 2, 3, and 4 under 
the options header. 


TABLE 3-1 OPTION SYMBOLS DISPLAYED BY THE 
INTERROGATE COMMAND 


om a em ce eR a a ne a ee OS a et OE eh mee Mm em ee i mi ee meme WNL ty nate at rs FY nae a Acme sm a mR IN ans I ran Ee mime re 


without VFC. 


tae me ee me rm re ne eee ree ete ee eee me me ee ee eee ee ce ee ee ee ee ee ee ee 


OPTION ; { CHARACTER POSITION } 
SYMBOL | DEFINITION {| IN OPTION COLUMN | RESULT 

H i Hold 1 | Output request is held 
{ ; on the queue until 
i { released. 

R i Release H i Allows a held output 
H H | request to become 
H | @€ligible for output. 

I H Image { 2 i File is to be output 
f as is. 
; Noimage { | File is to be output 
H H | in formatted mode. 
{ y t 
t { ’ 

D i Delete H 3 i File is deleted after 
{| output. 
| Nodelete (| { File is not deleted 
H | after output. 
I 1 ‘ 
! { { 

Vv ; VFC { 4 | File is to be output 
i i i with vertical forms 
H H | control (VFC). 
| NOVFC i i File is to be output 
( ! J 
I } { 


ee ae ee re es ee oe re Re ee ee eee en a eee ee 
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3.3.5.2 Displaying Queue Entries According to Preprinted 
Form Requests 


The FORM parameter of the INTERROGATE command causes all entries 


on the spool queue that require the specified form to be 
displayed. 


Example: 
INTERROGATE FORM CHECKS 


Resultant Display: 


PSEUDO 

DEVICE FILE NAME FORMNAME COP PRI OPTIONS 
PD2: M300: @TESTOO5.000/119 CHECKS 2 128 H I D 
PDS: M300: @TESTO06.000/119 CHECKS 90 129 H I 
PD6: M67B: @RUNTOO8 .000/118 CHECKS 120 129 H I D 


This example displays information about all spool queue entries 
that requested the special form CHECKS. The characters in the 
option column are defined in Table 3-1. 


3.3.5.3 Displaying Files by Assigned Pseudo Device 


The PD: parameter of the INTERROGATE command displays all spool 


files on the queue that are assigned to the specified pseudo 
device. 


Example: 
INTERROGATE PD PDI: 


Resultant Display: 


PSEUDO 

DEVICE FILE NAME FORMNAME COP PRI OPTIONS 
PDs M300: @PROGOO1.000/118 STD 5 128 H I D 
PDL: M300: @PROGOO2.001/118 STD 6 128 R I 
PDL: M300: @PROGOO2.000/118 STD 1 128 R I D 
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The preceding example displays all spool files that are assigned 
to pseudo device PDl:. The characters in the OPTIONS column are 
defined in Table 3-1. 


3.3.5.4 Displaying Information About a Particular File 

The FD parameter of the INTERROGATE command displays information 
about a specified file. 

Example: 


INTERROGATE FD DATAFILE 


‘Resultant Display: 


PSEUDO 
DEVICE FILE NAME FORMNAME COP PRI OPTIONS 
PD2: M300: @DATAON01.001/119 STD L 128 H DV 


This example displays information about the specified file 
DATAF ILE. The characters in the options column are defined in 
Table 3-1. 


3.3.5.5 Displaying the Spooler Environment Configuration 
The CONFIGURATION parameter of the INTERROGATE command displays 
the status of all physical devices in the spooler environment. 


Example: 


INTERROGATE CONFIGURATION 
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Resultant Display: 


ASSOC [ATED 

REAL DEVICE FORM ACTIVE PSEUDO 
DEVICE STATUS MOUNTED FILE DEVICES 

PRT 1: I STD NONE PD1:,PD2:,PD3: 

PRT2: A CHECKS M67B:@DAVIO03.001/119 PD6: 

PRT3: P STD M67B:TEST.PRT/100 PD1: ,PD7: 

LEGEND 

I = Inactive 

A = Active 

P = Paused 


This example displays all physical devices in the _ spooler 
environment, the status of the device, the file (if any) 
currently printing on the device, the form mounted on the device, 
and the pseudo devices associated with the physical device. 


3.3.5.6 Displaying All Spool Queue and Spooler Configuration 

Information 
If the INTERROGATE command is entered with no parameters, all 
queue information and the spooling environment configuration are 


displayed. The queve information displayed is dependent upon the 
requestor's authorization level. 


Example: 


INTERROGATE 
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Resultant Display: 


PSEUDO 

DEVICE FILE NAME FORMNAME COP PRI OPTIONS 
PD1: M67B: @COPY003.000/119 STD 2 128 H DV 
PD2: M300: @TESTOO04.001/120 STD 10 129 H I 

ASSOCIATED 

REAL DEVICE FORM PSEUDO 

DEVICE STATUS MOUNTED ACTIVE FILE DEVICES 
PRT1L: I STD NONE PDL: 
PRT2: A STD M67B: @COPY003 .000/119 PDL: 
PRT3: P STD M300: @TESTO04.000/120 PD2: 

LEGEND 

I = Inactive 


A = Active 


P = Paused 


3.3.5.7 Functional Discussion of the INTERROGATE Command 


Information displayed in response to an INTERROGATE command is 
dependent upon the authorization level of the device issuing the 


request. If a request is issued with primary authorization, the 
information displayed pertains to all entries currently on the 
spool queue. If the request is issued with secondary 


authorization, the information displayed pertains to the spool 
queue entries placed on the queue by members of the group that 
the secondary level of authorization applies to. If the request 
is issued with user authorization, only the spool queue entries 
placed on the queue by that user are displayed. 
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CHAPTER 4 
OUTPUT SPOOLING 


4.1 INTRODUCTION 


The SPL/32 output spooling feature provides a variety of 
functions designed to handle the processing of output files. The 
printing or punching of a spool file is handled by the output 
spooler. The management of files on the spool queue waiting to 
be output is performed by the uniform spooler control interface 
(USCI). This interface is discussed in Appendix D. 


The configuration of the output spooling environment can _ be 
Lailored to optimize the benefits of spooling for each particular 
system. This can be done when the spooler is started or 
dynamically while the spooler is active. 


The following features are provided as a function of output 
spooling: 


e The number of output devices is dependent only on the = amount 
of available memory. 


e Capability of retaining a spooled output file after it is sent 
to a device. 


e Capability of holding spooled files from output processing. 

e® The option to backspace, forward space, or rewind a file that 
is currently being output by the spooler, and then resume 
output. 


e The option to produce up to 255 copies of an output file. 


e The option to print informative header and trailer pages to 
identify output files. 


e The capability of using preprinted forms and testing for form 
alignment before output. 


e The capability to alter the output requirements of ae file 
waiting to be output. 


e ‘The capability to alter the order in which files are output. 


e The capability to control devices within the output spooling 
environment. 


e The capability to quiesce the entire output spooling function 
or individual devices in an orderly fashion. 
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4.2 THE PSEUDO DEVICE 


A pseudo device is a symbolic device reference whose function is 
to establish a correlation between a user/task and a physical 
output device. Within the output spooling environment, output 
files are directed to pseudo devices rather than directly to 
physical output devices. This provides two general benefits: 


e The routing of output data is not limited to a single physical 
output device. A pseudo device can be associated with many 
physical output devices and output can be directed by the 
spooler to the first available of these many physical devices. 


e The configuration and relationships between pseudo and 
physical devices can be altered while the spooler is active. 


When a task or user assigns a file for output to a pseudo device, 
the spooler translates the assign as a request to use a_ physical 
output device associated with the pseudo device. 


Pseudo devices can be created and deleted while the spooler is 
active and can be logically associated with one or more physical 
output devices. When a physical device is associated with a 
pseudo device, it becomes assigned exclusively to the spooler and 
cannot be used by any other task except through the spooler. 
Pseudo devices are represented by 1- to 4-character alphanumeric 
identifiers; the first character must be alphabetic, the 
remaining may be alphanumeric. 


~The following sections detail the process of creating, 
configuring, and using pseudo devices during output spooling. 


4.2.1 The Global Pseudo Device 


The global pseudo device is the default system pseudo device. If 
a pseudo device is not specified in a PRINT or PUNCH request, the 
file will automatically be assigned to the global pseudo device. 
This enables a user to request the output of a file even though 
the user is not aware of the specific pseudo device names present 
in the spooling environment or is not concerned with having a 
file output on a specific device. 


When the spooler is started, a global pseudo device called PR: 
is the default pseudo device for the output spooling environment. 
All requests to output files that do not explicitly specify a 
pseudo device are assigned to the global pseudo device, which is 
associated with all physical output devices in the spooling 
environment. The global pseudo device name can be changed via 
the GLOBAL command. Primary authorization is required to change 
the global pseudo device. 
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Example: 
GLOBAL PRS: 
The global pseudo device name is changed from PR: to PR9:. 


4.2.2 Creating Pseudo Devices In the Spooling Environment 


The initial spooling environment will contain only the _ global 
pseudo device unless other pseudo devices are introduced into the 
environment. Pseudo devices can be created in the spooling 
environment in two ways: 


@® explicitly, via the CREATE command, or 


e implicitly, via the ATTACH command. 


The CREATE command is used to specify new pseudo devices in the 
spooling environment. 


Example: 
CREATE PD1:,PD2:,PD3: 


PD1:, PD2:, and PD3: are to be recognized as valid pseudo device 
names. Up to 20 pseudo devices can be specified in a_ single 
CREATE command. 


[f the pseudo device name specified in an ATTACH command does not 
exist in the spooling environment, SPL/32 will create it and the. 
following message is displayed: 


IMPLICITLY CREATED PSEUDO DEVICE: pd: 


Pseudo devices can be created when the spooler is started by 
including the CREATE conimand in the start command file, or they 
can be created while the spooler is active. Once a pseudo device 
has been created, it must then be associated with physical output 
devices. If a pseudo device is not associated with a physical 
output device, spool files assigned to that pseudo device will 
remain on the spool queue and will not be output. 
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4.2.3 Associating Pseudo Devices with Physical Devices 


The process of associating a pseudo device with physical output 
devices is accomplished via the ATTACH command. 


Example: 


ATTACH PDEVICE = PD1: RDEVICE = PRTL: 


The pseudo device PD1l: is logically associated with the physical 
print device PRT1:. If pseudo device PDI: does not exist, 
SPL/32 will create it and then notify the initiator, as detailed 
in the previous section. 


Multiple physical devices can also be associated with a single 
pseudo device. 


Example: 


ATTACH PDEVICE = PD1: RDEVICE = PRT2:,PRT3:,PRT4: 


The pseudo device PD1: is logically associated with the physical 
print devices PRT2:, PRT3:, and PRT4:. When a pseudo device is 
associated with multiple physical devices, the output files 
assigned to that pseudo device can be sent to any one of the 
multiple physical devices based on immediate availability. 


When a pseudo device is associated with multiple physical 
devices, the device attributes for the pseudo device are defined 
by the last physical device attached to the pseudo device. The 
logical record length for the pseudo device is determined by the 
physical device with the largest logical record length associated 
with the pseudo device via an ATTACH command. Therefore, insure 
that the physical devices associated with a single pseudo device 
have like device attributes. 


NOTE 


If a pseudo device is not associated with 
any physical output device, output 
assigned to that pseudo device will not 
be output and will remain on the spool 
queue until the pseudo device is 
associated with a physical device or the 
files are flushed. 
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4.2.4 Directing Output to a Pseudo Device 


Users can direct output to a pseudo device by using one of the 
following spooler commands: 


@ PRINT 
e@ PUNCH 


e CHANGE 
Examples: 


PRINT TESTRUN.CBL/120,DEVICE=PD3: 

PUNCH CALC32.CAL/119,DEVICE=PD4: 
File TESTRUN.CBL in account 120 is directed to pseudo device PD3: 
for output. File CALC32.CAL in account 119 is directed to pseudo 
device PD4: for output. The CHANGE command can be used to 


change the pseudo device specification of a previous PRINT or 
PUNCH command while the file is on the spool queue. 


Example: 
CHANGE CALC32.CAL/119,DEVICE=PD3: 
File CALC32.CAL in account 119, previously directed to pseudo 
device PD4: is now directed to pseudo device PD3:. 
A user can specify the following optional output parameters when 
directing output to a pseudo device via the PRINT or PUNCH 
commands or can change these parameters via the CHANGE command: 
e ‘The number of copies of a file to be produced 
e Whether a preprinted form is to be used 
e The output priority of a file 
e The output format of the file (IMAGE, VFC, NOIMAGE, NOVFC) 
@ Whether the file is to be deleted after output 
@ Whether the checkpointing feature is to be used 


e Whether a file is to be held on the spool queue 
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4.2.5 Limiting Default Access to a Pseudo Device 


Although files assigned to the global pseudo device can be output 
to any of the physical output devices present in the_- spooling 


environment, this type of access can be restricted for specified 
pseudo devices and consequently, the physical devices associated 
with them. This restriction is accomplished via the RESTRICT 


parameter of the DEVICE command. 


Example: 


DEVICE PD1:,RESTRICT 


Pseudo device PD1l: now has restricted access. This means. only 
explicit assignments to PDI: in a PRINT, PUNCH, or CHANGE 
request will be accepted for output on PD1l:. Assignments to the 
global pseudo device will not be output to the physical devices 
associated with PD1l:. Removing the restricted access’ condition 
from a pseudo device is accomplished via the FREE parameter of 
the DEVICE command. 


Example: 


DEVICE PD1:,FREE 


Pseudo device PD1: has no access restrictions. A file assigned 
to the global pseudo device can eventually be output on one of 
the physical devices associated with pseudo device PDI1:. 


4.2.6 Establishing Unique Default Print Locations 


Unique default print locations can be established for a specified 


set of tasks or terminals. This is particularly useful for 
grouping units that perform a common function, such as word 
processing terminals and a high quality printer. The printer is 


established as the default print location for those terminals. 
Unique default print locations are established via the GROUP 
command. 


Example: 


GROUP PDEVICE=PD7: INCILUDE CRT1:,CRT2:,CRT3: 
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A group of terminals (CRT1l:, CRT2:, CRT3:) are logically 
associated with the pseudo device PD7:. By associating PD7: 
with physical device PRT7:, output assigned to the global pseudo 
device from any of those three terminals is sent to PD7: and 
subsequently printed on PRT7:. 


The default print location for a group differs from the global 
default print location; however, the manner’ in which a user 
assigns to either default location is the same. 

A task or terminal can be associated with one default print 
location only, either the global default print location or a 


group default print location. A task or terminal is removed from 
a group via the REMOVE option of the GROUP command. 


Example: 
GROUP PDEVICE=PD2: REMOVE CRT2: 


CRT2: is no longer associated with a group and will now use the 
global pseudo device to determine a default print location. 


4.2.7 Disassoclating Pseudo Devices From Physical Devices 


The association between a pseudo device and a physical device (or 
devices) is broken via the DETACH command. 


Example: 
DETACH PDEVICE=PD2: RDEVICE=PRT4: 


The physical device PRT4: is detached from pseudo device PD2:. 
[If the physical device specified is not associated with any other 
pseudo device, the logical unit (lu) assigned to that physical 
device is closed. However, if it is associated with another 
pseudo device, that association remains unaffected. Up to 19 
physical devices can be specified in a single DETACH command. 


4.2.8 Deleting Pseudo Devices From the Spooling Environment 
Pseudo devices are deleted from the spooling environment via the 
DELETE command. 


Example: 


DELETE PD1:,PD2: 
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Pseudo devices PD1: and PD2: are deleted from the spooling 
environment. 


When a pseudo device is deleted, its association with any 
physical device is also deleted. Subsequent assignments to the 
deleted pseudo device are rejected; however, assignments’) already 
on the spool queue are allowed to complete. 


4.3. PHYSICAL OUTPUT DEVICE CONTROL 


Physical output devices) are introduced in the spooling 
environment when they are associated with pseudo devices in the 
ATTACH command as previously shown in Section 4.2.3. The 


following sections detail how these devices can be controlled. 


4.3.1 Altering the Status of Physical Output Devices 

The status of physical output devices can be altered via the 
DEVICE command, which provides the system operator with the 
ability to: 

e suspend a physical output device (delayed or immediately), 

e continue a physical output device that was suspended, 

e reposition a file being output on a specific physical device 


in four ways: 


1. The file may be forward spaced a specified number of 


lines. 

2. The file may be backspaced a specified number of lines. 

3. The file may be forward spaced a specified number of 
pages. 


4. The file may be backspaced a specified number of pages. 


@e Rewind the file being output on a physical device to the 
beginning of the file and resume output. 


Examples of the use of the DEVICE command to perform these 
functions follow. 


Example: 
DEVICE PRT1:, SUSPEND IMMEDIATE 


DEVICE PRT2:, SUSPEND DELAYED 
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The printer PRT1: is suspended immediately; printer PRT2: will 
be suspended when the currently printing file has completed. 


Example: 
DEVICE PRT1:, CONTINUE 


This example demonstrates how to continue a physical device 
(PRT1: ) that was previously paused. The file that was being 
printed on PRT1L: when the PAUSE command was issued will resume 
output starting with the next record. 


Example: 


DEVICE PRT1:, SUSPEND IMMEDIATE 

DEVICE PRT1:, FLINE = 25 
This example suspends printer PRT1:, forward spaces the file 
being output on device PRT1: 25 lines, and resumes printing the 
file. The entry of a position parameter in the DEVICE command, 
such as FLINE, implicitly causes a suspended device to resume 
output. It is not necessary to enter a CONTINUE parameter. 
Section 6.10 provides complete details on the use of the DEVICE 
command. 


4.3.2 Removing Files From The Spool Queue 


Files can be removed from the spool queue via the FLUSH command. 
Example: 

FLUSH TEXTFILE.STD/119 
The specified file (TEXTFILE.STD/119) is removed from the spool 


queue. 


Files can also be removed from the spool queue and also deleted 
from disk in the same operation via the DELETE option of the 
fLUSH command. 


Example: 


FLUSH TEXTFILE.NEW/118,DELETE 
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The specified file (TEXTFILE.NEW) is removed from the spool queue 
and deleted from disk (if it is not currently being printed). If 
“the file is currently being printed, it will not be deleted from 
disk. 

A file can also be deleted from the physical device on which the 
file is being output. 

Example: 


FLUSH PRT1: 


I/O to the specified device PRT1: is immediately terminated and 
the file being output on the specified device is deleted from the 
spool queue. This option is useful for terminating [/O to a 
malfunctioning printer or a remote printer without knowing the 
name of the file being output on the printer. 

4.3.3 Removing Physical Devices From the Spooling Environment 

Physical devices are removed from the spooling environment via 
the DELETE command. 

Example: 


DELETE PRT7: 


Physical GQevice PRT7: is deleted from the spooling environment. 
When a physical device is deleted, its association with any 
pseudo device is also deleted. If a file is being output on the 
device when it is deleted, the output is allowed to finish. 

4.4 USING PREPRINTED FORMS 

Another feature of SPL/32 is the ability to handle and manipulate 
special forms in the spooling environment. SPL/32 provides 
facilities to: 

® name forms, 

e characterize the format of a form, 


e associate forms with specific printers, and 


e verify alignment of a mounted form prior to use. 
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The following sections describe how these facilities can be used. 


4.4.1 Naming and Characterizing Preprinted Forms 


In order to use preprinted forms in the spooling environment, the 
forms must first be identified to the _ spooler. The physical 
print area of the form can be characterized, or the default print 
area values can be used. This is accomplished via the INCLUDE 
parameter of the FORM command. 


Example: 
' FORM INCLUDE REPORT1 (PLENGTH=60 BMARGIN=10 TMARGIN=5 PWIDTH=132) 


The form REPORT1 is included as a valid form name and is given a 
page length of 60 lines, a_ bottom margin of 10 lines, a top 
margin of 5 lines, and a page width of 132 columns. 


Up to four forms may be included in a single FORM command. The 
spooler has a predefined form name standard (STD) that represents 
the paper in standard use. STD is the default print form, and at 
spooler start time it is assumed that STD is mounted on all print 
devices. The primary and secondary authorization levels may 
INCLUDE or REMOVE form names from the spooling environment. If 
a PRINT or PUNCH request specifies a form that has not been 
included in the spooling environment, the spooler will output the 
following message: 


INVALID FORM: formname 
and output the file on the default standard form STD. 
4.4.2 Associating a Form With a Physical Device 
Once a form has been identified as a valid form in the spooler 
environment, the user can specify what physical device that form 


is mounted on. This is accomplished via the MOUNT parameter of 
the FORM command. 


Example: 
FORM MOUNT TWOPART, PRT2: 
The spooler is notified that form TWOPART is mounted on printer 


PRT2:. 
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Once a form has been associated with a device, the _ spooler 
retains this association information. Subsequent print requests 
that specify a particular form must be directed to the pseudo 
device that is associated with the printer holding the desired 
form. SPL/32 will direct the file to the desired physical device 
for output as long as the correct pseudo device is specified. 
SPL/32 also provides the option to verify the alignment of a form 
that has been mounted on a printer. 

Example: 


FORM MOUNT TWOPART VERIFY=1, PRT1L: 


This notifies the spooler that the form TWOPART is mounted on 
device PRT1l:. The device will be paused after the first page of 
the first file is printed, and the following message is output to 
the control task monitoring the printer: 


VERIFY COMPLETE ON: device name 
The operator can then realign the form (if necessary), rewind the 


input file and resume output. 


If a file is placed on the spool queue that requires a form that. 
is not currently mounted on any device, the following message is 
sent to the operator: 


REQUEST IS PENDING FOR FORM form name 


The spool file will remain on the queue until the specified form 
is mounted or until the file is flushed. 


4.4.3 Removing Forms From the Spooling Environment 
Forms are removed from the spooling environment via the REMOVE 
parameter of the FORM command. 


Example: 


FORM REMOVE REPORT1 


4-12 48-056 FOO RQ0 


Form REPORT1 is removed from the list of valid form names 
maintained by the spooler. Subsequent requests for the form 
REPORT] are printed on the standard form STD and the warning 
message: 


INVALID FORM: form name 


is generated. Any entry on the spool queue that requires’ the 
removed form will remain on the queue until the required form is 
mounted. 


4.5 USING IDENTIFICATION PAGES 


SPL/32 provides the capability to uniquely identify printed 
output through the use of identification pages that precede the 
file to be output (BANNER PAGES) or follow the file to be output 
(TRAILER PAGES). The user has the option to use one or both of 


these identification pages. The user can specify the character 
to be used by the spooler to generate the BANNER or TRAILER 
pages. The default character is 0. The default BANNER and 


TRAILER pages contain the following information about each file: 


e file descriptor, 

@® user account number, 

e date and time the file was output, and 
e taskname. 


The user can specify any combination of these default parameters 
plus the following optional information: 


e@ al- to 12-character user-specified message. 


In addition to the above information, an information block is 
printed at the bottom of each BANNER or TRAILER page which 
consists of the following information: 

@® pseudo device 

@ real device 

e full fd 


@® user account number 


@® queue time 
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The user has the option to specify whether single, double, or no 
identification pages are to be generated. Banner page and 
trailer page specifications are established via the BANNER and 
TRAILER commands, respectively. 


Examples: 


BANNER PD1:, DOUBLE 


TRAILER PD1:, SINGLE 


These examples establish a double banner page and a single 
trailer page for each file output on pseudo device PD1:. Each 
identification page will contain the default information set. 


Banner and trailer page specifications can be directed at either 
a pseudo device or a physical device. Once a device has been 
associated with banner or trailer page specifications, all files 
subsequently output on that device will be identified according 
to that specification until a new BANNER or TRAILER command is 
issued. 


4.6 USING THE CHECKPOINT FEATURE 


The CHECKPOINT feature is a protective option of SPL/32 designed 
to eliminate the need to reprint entire files when the output of 
a file is interrupted due to a system failure or I/O error. [ft 
a failure occurs while the CHECKPOINT option is in effect, a file 
being output at the time of the failure is repositioned to the 
last record checkpointed, and output is resumed when the system 
is restarted. This is a particularly useful feature when very 
large files are being output because it eliminates the need to 
begin printing files from the beginning of file after failures. 


To use the checkpoint feature, two requirements must be 
satisfied: 

1. The global CHECKPOINT option must be on. 

2. The CHECKPOINT option must be specified in the PRINT, PUNCH, 


ASSIGN, SPOOLFILE, or CHANGE command that submits a file for 
output. 


If either of these conditions is not met, checkpointing is not 
performed. The global CHECKPOINT option is turned on via the 
CHECKPOINT command. 
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Example: 
CHECKPOINT ON, 80 


This example turns the CHECKPOINT feature on and specifies that 
a checkpoint is to be performed after each 80 records output. 
The number specified represents the largest number of records 
that would have to be reprinted if a system failure occurs. Once 
the global CHECKPOINT feature has been turned on, as the above 
example shows, a user can request that a file be checkpointed by 
specifying the CHECKPOINT option in the PRINT, PUNCH, or CHANGE 
command. 


Examples: 


PRINT REPORT.NO1/119,DEVICE=PR2: , CHECKPOINT 
PUNCH TEST32.CAL/120,DEVICE=PR3: , CHECKPOINT 


CHANGE SCAN32.CAL/119,DEVICE=PD1: , CHECKPOINT 


The files in these examples will be checkpointed when output, as 
long as the global checkpoint feature is on. If the global 
checkpoint feature is off, checkpointing will not be performed. 
Therefore, it is advisable to make sure the global checkpoint 
feature is on before attempting to use the CHECKPOINT feature. 
Entering the CHECKPOINT command without parameters will result in 
a display of the checkpoint value if global checkpointing is on. 
[ff no value is displayed, global checkpointing is off. 


4.6.1 Turning Checkpointing Off 


Global checkKpointing is turned off via the OFF parameter of the 
CHECKPOINT command. 
Example: 


CHECKPOINT OFF 


The global checkpoint feature is off and checkpointing cannot be 
performed. Checkpointing can also be turned off at the 
user-level if the global checkpoint feature is on. This is 
accomplished by specifying the NOCHECKPOINT parameter in a PRINT, 
PUNCH, ASSIGN, SPOOLFILE, or CHANGE command. 
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Example: 


PRINT TESTPROG.CAL/119,DEVICE=PR: , NOCHECKPOINT 
PUNCH STATTEST.CAL/120,DEVICE=PD2: ,NOCHECKPOINT 


CHANGE REPORT.TEX/118,DEVICE=PD7: , NOCHECKPOINT 


4.7 OUTPUT PRIORITY 


Spool files are output ona priority basis. Each file assigned 
for output is given a priority value, either implicitly or 
explicitly. This priority number is used by the spooler to 
determine the order in which files will be output; files with the 
lower priority number are output first. The priority of a spool 
file is explicitly assigned in the PRIORITY= parameter of a 
PRINT, PUNCH, or CHANGE request. When this priority is not 
specified, the file is given the default priority of the system. 
When a file is placed on the spool queue, it has two priorities 
associated with it: 


e a global priority, and 

@e a user priority. 

The global priority is the priority of the file with respect to 
all other spool files. The user priority is the priority of the 
file with respect to all spool files initiating from the same 
user and having the same global priority. 

When a PRINT, PUNCH, or CHANGE command is issued from a unit with 
primary or secondary authorization, the PRIORITY= keyword refers 
to the global priority of the file. When a PRINT, PUNCH, or 
CHANGE command is issued from a unit with user authoriziation, 
the PRIORITY= keyword refers to the user priority of the file. 
See Chapter 5 for a discussion of authorization levels. 

4.7.1 Changing the Global Default Priority 

The global default priority value is changed via the PRIORITY 
commmand. 

Example: 


PRIORITY 132 


This example sets the global default priority to 132. 
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If the PRIORITY command is omitted at spooler startup, the 
default priority is set at 128. The priority may be changed 
while the spooler is active, but only primary authorization can 
change the global default priority. 


4.7.2 Altering the Output Priority of a Spool File 


SPL/32 provides the capability to alter the output priority of 
spool files waiting on the spool queue. This is accomplished via 
the PRIORITY= keyword of the CHANGE command. 


For example, if the file PAYROLL.CHK in account 119 was”) residing 
on the spool queue waiting to be printed, the file has a priority 
of 118. To alter that priority the user enters the following 
CHANGE command: 


Example: 


CHANGE PAYROLL.CHK/119,PRIORITY=120 


The output priority of the file PAYROLL.CHK is altered to 120. 


The degree to which the output priority of a file can be altered 
depends upon the authorization level of the CHANGE command. The 
following general conventions are used: 


e Primary authorization allows the output priority of a file to 
be altered relative to all other files in the spooling 
environment. 


e Secondary authorization allows the output priority of a file 
to be altered relative to all other files in the spooling 
environment that were placed on the spool queue with the same 
secondary authorization. 


e User authorization allows a user to alter the output priority 


of a file relative to any other files placed on the queue by 
that user. 
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CHAPTER 5 
TASKS AND LEVELS OF AUTHORIZATION 


5.1 INTRODUCTION 


SPL/32 recognizes three types of tasks in the spooling 
environment: 


e Control tasks 
e Subcontrol tasks 


e User-level tasks 


These three task types have descending degrees of control in the 
spooling environment relative to issuing spooler commands, 
controlling spooled devices, and monitoring spooled devices. ‘The 
capabilities that a spooler command has when issued from one _ of. 
these types of tasks is directly related to the authorization 
level of the issuing task. There are three Levels of 
author ization: 


e@e Primary 
@® Secondary 


@e User 


The three types of tasks and three levels of authorization are 
not directly related. Control tasks are not Limited to primary 
authorization because they can also have’ secondary or user 
authorization. Subcontrol tasks can have secondary or user 
authorization. User-level tasks are restricted to user 
authorization. 


Bach of these three tasks is designed to perform a_e specific 
function or functions. Control tasks communicate directly with 
the spooler and receive responses directly from the spooler. 


Subcontrol tasks communicate directly with the spooler but’ can 
have spooler responses selectively routed either to themselves or 
to an associated control task. User-level tasks communicate with 
the spooler only through a control task or via an assign to a 
pseudo device. 
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5.2 CONTROL TASKS AND THEIR COMMUNICATION WITH THE SPOOLER 


Control tasks are designed to control spool devices and the 
spooling environment and to monitor the status of these devices. 
Control of spool devices is accomplished through the use of 
spooler commands. Control tasks can issue command requests 
directly to the spooler and receive messages or data as a 
consequence of the request. Control tasks monitor devices by 
receiving messages from the spooler that pertain to device status 
ox I/O status within the control task's’~ environment. Control 
tasks communicate with the spooler via three types of messages. 
These specify functions that control tasks perform on behalf of 
the tasks/devices in their environment. The three message types 
are: 


e Command messages 
e Acceptance messages 


e Request for mnemonic table messages 


The formats of these messages are presented in Appendix D. All 
communications between tasks and the spooler are preceded by 
general information that identifies the origin of the message, 
the type of message, and other related information. This 
information is contained in a record called the message header. 
Appendix D details the contents and format of the message header. 


5.2.1 Command Messages 


Command messages are sent from a control task to the spooler and 
contain spooler commands that direct the spooler to perform a 
service. These commands can be sent in ASCII or preparsed form. 


5.2.2 Acceptance Messages 


Acceptance messages are sent from a control task to the spooler 
as a response to an authorization identifier change request. 
Acceptance messages indicate whether the authorization identifier 
passed to a particular control task is acceptable or not. 


5.2.3 Request for Mnemonic Table Messages 
Request for mnemonic table messages are sent from a control task 
to the spooler to request the spooler's command mnemonic table. 


The control task can then use this table to identify valid 
command mnemonics. 
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5.3 SPOOLER COMMUNICATION WITH CONTROL TASKS 

The spooler communicates with control tasks via five types of 
messages: 

e Service response messages 

® Exception response messages 

@e Authority messages 

@® Attention messages 


e Mnemonic messages 


The formats of these messages are presented in Appendix D. 


5.3.1 Service Response Messages 


Service response messages are sent from the spooler to a_ control 
task when a command issued from the control task is valid and 
requires a data response from the spooler. 


5.3.2 Exception Response Messages 


Exception response messages are sent from the spooler to a 
control task when an invalid command is issued from the control 
task. 


5.3.3 Authority Messages 


Authority messages are sent from the spooler to a receiving 
control task. The receiving control task is notified that it is 
being given the authority to recognize attention messages. 


5.3.4 Attention Messages 
Attention messages are sent from the spooler to a control task to 
notify the control task of a situation that occurred internal to 


the spooler and requires a control task or operator to be 
notified. 


5.3.5 Mnemonic Messages 
Mnemonic messages are sent from the spooler to a control task to 


notify the control task of the valid spooler commands that should 
be passed to the spooler for execution. 


48-056 FOO ROO hs eae 


5.4 INCLUDING CONTROL TASKS IN THE SPOOLING ENVIRONMENT 


Control tasks are added to the spooling environment via _ the 
INCLUDE parameter of the CTASK command. 
Example: 


CTASK INCLUDE .MTM 


The spooler now recognizes MTM as a control task. Control tasks 
can be specified at spooler start time in the START command file 
or they can be added to the spooling environment while the 


spooler is active. If no control tasks are specified in the 
spooling environment at start time, the spooler, by default, 
specifies control task .SPL. Communication with the spooler 


through the control task .SPL is accomplished by entering spooler 
commands at the system console. 
5.5 DISPLAYING CONTROL TASKS IN THE SPOOLING ENVIRONMENT 


The names of all control tasks in the spooling environment can be 
displayed by entering the CTASK command without parameters. 


In the following example, tasks TEST1, TEST2, and TEST3 are 
designated as control tasks. The CTASK command is then entered 
without parameters to display the control tasks in the spooling 
environment. 


Example: 


*TASK INCLUDE TEST1,TEST2,TEST3 
*CTASK 
*CTASKS=TEST1, TEST2, TEST3 


5.6 REMOVING CONTROL TASKS FROM THE SPOOLING ENVIRONMENT 
Control tasks are removed from the spooling environment via_ the 
REMOVE parameter of the CTASK command. 


Example: 


CTASK REMOVE .MTM 
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Control task MTM is removed from the spooling environment. When 
a control task is removed from the spooling environment, any 
subcontrol tasks associated with the control task are also 
removed. See Section 5.7 on subcontrol tasks. 


Control tasks may be removed from the spooling environment while 
the spooler is active. 


5.7 SUBCONTROL TASKS AND THEIR COMMUNICATION WITH THE SPOOLER 


Subcontrol tasks issue command requests directly to the’ spooler. 
Messages or data generated by the spooler in response to a 
command issued from a subcontrol task can be routed, either to 
the subcontrol task that issued the command or to the control 
task that is monitoring the subcontrol task that issued the 
command. The routing is determined by the routing flag field 
located in the message header that precedes the _ subcontrol 
command request. See Appendix D for detailed information on this 
procedure. Subcontrol tasks communicate with the spooler via 
command messages. 


The format of a command message is presented in Appendix D. All 
communication between subcontrol tasks and the _ spooler is 
preceded by general information that identifies the origin of a 


message, the type of message, and other related information. 
This information is contained in a record called the message 
header. Appendix D presents a detailed breakdown of the message 


header record. 


5.7.1 Command Messages 
Command messages are sent from a subcontrol task to the spooler 
and contain spooler commands that direct the spooler to perform 


a service. These commands can be issued in ASCII or preparsed 
form. 


5.8 SPOOLER COMMUNICATION WITH SUBCONTROL TASKS 
A subcontrol task can only receive responses to command messages 


it issued. There are two types of responses a subcontrol task 
can receive from the spooler: 


e Service response messaces 


e Exception response messages 


The formats of these records are presented in Appendix D. 
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5.8.1 Service Response Messages 


Service response messages are sent from the spooler to a 
subcontrol task when a command issued by the subcontrol task is 
valid and requires a data response. 


5.8 2 Exception Response Messages 


Exception response messages are sent from the spooler to a 
subcontrol task when an invalid command is issued by the 
subcontrol task. 


5.9 INCLUDING SUBCONTROL TASKS IN THE SPOOLING ENVIRONMENT 


Subcontrol tasks are included in the spooling environment via the 
INCLUDE parameter of the SCTASK command. 


Example: 
SCTASK CTASK=.MTM INCLUDE TASKONE 


TASKONE is designated as a subcontrol task in the_ spooling 
environment with the control task .MTM as its monitor task. 


When a subcontrol task is included in the spooling environment, 
it must be associated with a monitor control task. This monitor 
control task can be explicitly specified in the SCTASK command, 
as in the above example. If specification of a monitor control 
task is omitted, the spooler implicitly associates the control 
task that issued the SCTASK command as the monitor control task. 


5.10 DISPLAYING SUBCONTROL TASKS IN THE SPOOLING ENVIRONMENT 


The subcontrol tasks present in the spooling environment can be 
displayed by entering the SCTASK command without parameters. The 
monitor control task is displayed with each subcontrol task. 


In the following example, a number of subcontrol tasks are 
assigned under two monitor control tasks, MONITOR1 and MONITOR2. 
These subcontrol tasks are then displayed with their associated 
monitor control task. 


Example: 


*SCTASK CTASK=MONITOR1 INCLUDE TASK1, TASK2 
*SCTASK CTASK=MONITOR2 INCLUDE TASK3,TASK4 
*SCTASK 

*CTASK=MONITORIL SCTASKS=TASK1, TASK2 
*CTASK=MONITOR2 SCTASKS=TASK3 , TASK4 
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5.11 REMOVING SUBCONTROL TASKS FROM THE SPOOLING ENVIRONMENT 


Subcontrol tasks are removed from the spooling environment in one 
of two ways: 


e explicitly, via the REMOVE parameter of the SCTASK command, or 


@® implicitly, by removing the monitor control task of the 
subcontrol task. 


5.12 USER-LEVEL TASKS AND THEIR COMMUNICATION WITH THE SPOOLER 


Tasks within the spooling environment that are not designated as 
either control or subcontrol tasks are known as user-level tasks. 
User-level tasks cannot communicate directly with the spooler but 
can request the use of spooler functions in one of two ways: 


e by assigning to a pseudo device, and 


@ by passing spooler commands to the spooler through a monitor 
control task. 


When a user-level task assigns to a pseudo device, the operating 
system intercepts the SVC7 and then routes it to the spooler for 
execution. When a user-level task issues a command, such as- the 
INTERROGATE command, the command is first submitted to the 
control task monitoring the user-level task. This control task 


interprets the command and passes it to the spooler. The spooler 
does not track user-level tasks within the spooling environment. 
Therefore, commands originating from user-level tasks appear, to 


the spooler, to be originating from a control task. User-level 
tasks can actively use five spooler commands: 


@ PRINT 
e PUNCH 
e@ CHANGE 
e@ FIUSH 


e@ INTERROGATE 

These commands can only be used to affect entries that were 
placed on the spool queue on behalf of that user. 

A number of additional commands can be used by the user-level 


tasks to display current spooler environment information. 
However, the user-level cannot alter this environment. 


48-056 FOO ROO a leew 4 


5.13 LEVELS OF AUTHORIZATION 


Spooler commands have three levels of authorization associated 
with them: 


@® Primary 
® Secondary 


@ User 


Primary authorization is assigned to a task/device via _ the 
PRIMARY command. Secondary authorization is assigned to a 
task/device using the SECONDARY command. User authorization is 
implictly assigned whenever a task/terminal is not specified in 
a PRIMARY or SECONDARY command. 


Associated with each level of authorization is a set of the 
spooler commands that are valid only when used from a task/device 
that has the appropriate authorization level. This design 
enables the system administrator to maintain control over the 
spooler environment by limiting the number of tasks/devices that 
can alter the spooling environment or manipulate the status of 
spooled devices. Commands that require primary authorization, 
the highest level, are used to establish and maintain the global 
spooling environment. A task or device that has- primary 
authorization is able to use all spooler commands. Commands that 
require secondary authorization, the intermediate level, are used 
to control devices in a specific group of the spooling 
environment. A task or device that has secondary authorization 
is able to use commands at the secondary and user-levels, but 
cannot use the primary level commands. 


Commands that require user authorization, the lowest level, can 
alter the status of file entries placed on the spool queue on 
behalf of the user and can display information pertaining to’ the 
spooling environment. A task or device that has user-level 
authorization is restricted to using the user-level commands. 


Certain spooler commands are available for use at all three 
levels of authorization. However, the function these commands 
perform is dependent upon the authorization level of the 
task/device that issued the command. An INTERROGATE command 
issued at the primary level of authorization displays information 
about all entries on the spool queue. An INTERROGATE command 
issued at the secondary level of authorization displays 
information about the spool queue entries that were placed on the 
queue by a device or task using the same secondary authorization 
identifier as that contained in the INTERROGATE command. An 
[NTERROGATE command issued at the user-level of authorization 
displays entries on the spool queue that were sent by that user. 
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Another command that functions in this way is the CHANGE command. 
A CHANGE command issued at the primary level can modify any entry 
on the spool queue. A CHANGE command issued at the secondary 
level can modify the files placed on the spool queue by a device 
or task using the same secondary authorization identifier as that 
contained in the CHANGE command. A CHANGE command issued at’ the 
user-level can only alter file entries on the spool queue that 
were placed there by the user. Certain spooler commands set, 
specify, or alter a parameter when issued at the primary level of 
authorization. However, these same commands can only be used to 
display these parameters when issued at the _ secondary Or 
user-levels of authorization. 


An example of this is the BLOCK command. To set the default data 
and index block sizes, the BLOCK command requires primary 
authorization. When the BLOCK command is issued at the secondary 
or user-levels of authorization, the default data and index block 
sizes are displayed. Table 5-1 presents a summary of spooler 
commands available at each level of authorization and _ includes 
the function of each command at each level of authorization. 


TABLE 5-1 AUTHORIZATION LEVELS AND 
ASSOCIATED SPOOLER COMMANDS 


'’ 1 
1 t 
} SPOOLER | ---- ee + ee ee asec H 
\ COMMAND ! PRIMARY | SECONDARY } USER | 
| ToS eee eee eee ee ee eee eee eee eee Se ees | 
! ATTACH H ) ! NA i; NA } 
| BANNER ; a) H 8) ! NA } 
1 BLOCK H 0 i A i & H 
| CHANGE i * H * i; * i 
! CHECKPOINT |} ) H A | A i 
! CREATE { 0 H NA ' NA } 
! CTASK H 8) H A | & 
! DELETE \ a) ' NA ' NA }{ 
! DETACH \ 0 ! NA ' NA } 
! DEVICE H 0 ' ) ' NA } 
| FLUSH ! a) { x { * f 
| FORM H ) ' 0 i & { 
| GLOBAL i 0 { A i & i 
! GROUP H 0 i A i; A H 
! INPUT | a) H NA ! NA | 
} INTERROGATE |} * H x i * H 
' PRIMARY ' 0 | NA ! NA | 
! PRINT { * i x jes H 
! PRIORITY \ 8) ' A |. & 
| PUNCH H * H * H bs i 
| QUEUE i 0 } NA ' NA } 
| QUIESCE H 0 H NA ' NA } 
! SCTASK } 8) ' A | & { 
| SECONDARY i 8) ! NA ' NA } 
! SPVOLUME ' 8) i A | & | 
! TRAILE | 0 ' 8) + NA | 

O = authorization level able to set, * = aquthorization level able to use 

specify, or alter parameter. command. The impact of the command is 


limited according to the authorization 
&= authorization level able to display level of the issuing task/device. 
information. 


NA = command not available at this 
authorization level. 
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5.13.1 Authorization Identifiers CAID) 


The spooler recognizes the authorization level of a command 
request by reading the authorization identifier (AID) that 
accompanies it. The AID is carried in the message header of the 
command request (see Appendix D). The spooler then determines if 
the task or device issuing the command has the authority to issue 
that command. The AID is a 1- to 8-character alphanumeric name, 
the first character must be alphabetic, the remaining 
alphanumeric. There are two types of AIDs that can be present in 
the spooling environment: 


@ Primary AID 


@ Secondary AID 


There can be only one primary AID but there can be more than one 
secondary AID. The primary AID is specified or changed using the 
PRIMARY command. The PRIMARY command denotes a control task, 
that is to be the primary control task, and the AID that will 
accompany command requests that require primary authorization. 
The primary AID may be specified at spooler start time in the 
START command file and it may be changed while the spooler is 
active. If the PRIMARY command is omitted from the START command 
file, the task .SPL is loaded and becomes the default primary 
control task and INITPAID becomes the default primary AID. 


Secondary AIDs are specified using the SECONDARY command. The 
SECONDARY command specifies the AID, a control task, and a pseudo 
device to which the AID applies. The specified control task 
monitors the devices associated with the specified pseudo device. 
Command requests that will affect the _ status of devices 
associated with the specified pseudo device must contain the 
secondary AID or they will be rejected by the spooler. 


Secondary authorization provides control over a set of devices 
grouped under a particular pseudo device. The AID functions as 


a password preventing unauthorized access to the group 
env Lronment. There is no unique AID associated with the 
user-level of authorization. Command requests that do not 


contain a primary or secondary AID are implicitly assigned user 
authorization by the spooler. 


5.13.2 Origin Identifiers (OID) 


The origin identifer (OID) is a 1- to 8-character alphanumeric 
name that uniquely identifies a task or terminal. The OID is 
used by control tasks and the spooler. Control tasks use the OID 
to route messages or data from the spooler to the appropriate 
location within the control tasks environment. The spooler uses 
the OID (together with the AID) to determine default print 
locations for members of groups within the spooling environment. 
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CHAPTER 6 
SPL/32 COMMANDS 


6.1 INTRODUCTION 


Control of SPL/32 and the interaction between the user and SPL/32 
is accomplished through the use of SPL/32 commands. SPL/32 
commands may be entered at the system console and/or the user's 
terminal. The commands available to a particular terminal are 
directly related to the authority level of that terminal (see 
Chapter 5). This chapter presents each SPL/32 command with 
complete format and optional parameters, a description of the 
command's function, and examples of the use of each command. 


NOTE 
The use of colons when specifying pseudo 


devices or real devices within a command 
Line is entirely optional. 
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ATTACH 


6.2 ATTACH COMMAND 


The ATTACH command is used to logically associate a pseudo device 
(arbitrarily denoted by the user) with one or more real output 
devices; e.g., printers. This association may be accomplished 
without interruption of current spooler execution. 


Format: 
ATTACH PDEVICE=dev RDEVICE=devl[,dev2 ... ,dev19] 


Parameters: 


dev is a l- to 4-character alphanumeric designator 
(of which the first character must be 
alphabetic and the remaining characters 


alphanumeric) of the pseudo device to be 
implicitly created as a pseudo device if it 
does not exist in the spooler environment. 


devl,dev2, is a l- to 4-character alphanumeric designator 
...devl9 (of which the _ first character must be 
alphabetic and the remaining characters 


alphanumeric) of the real device (or devices) 
to be associated with the preceding pseudo 
device. Directing subsequent output to the 
pseudo device will result in the output being 
generated on the associated real device. A 
total of up to 19 real devices can be 
specified in a single ATTACH command. 


Functional Details: 


If more than one real device is associated with a pseudo device, 
the record length of the pseudo device is defined by the real 
device with the largest record length entered in the ATTACH 
command. The pseudo device attributes are defined by the last 
real device entered in an ATTACH command for that pseudo device. 
Therefore, when multiple real devices are associated with a 
single pseudo device, it is advisable to ensure that these real 
devices have like device attributes. Primary or secondary 
control unit authorization is required to use the ATTACH command. 
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Examples: 


ATTACH PDEVICE=PR1: RDEVICE= PRT1:, PRT2:, PRT3: 
The real devices PRT1l: and PRT2: are associated 
pseudo device PRI1:. 

ATTACH PD=PR1: RD=PRT3: 
The real device PRT3: .is associated with the 


device PRI1:. 
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6.3 BANNER COMMAND 


The BANNER command is_~ used to specify the number of 


identification 


page(s) printed with each file output on a 


specified pseudo or physical device, and to format the contents 
of this identification page to suit the user's needs. 


Format: 
DOUBLE 
pseudo dev: 
BANNER - SINGLE [, CHARACTER=character] [fd] 
real dev: 
NONE 


Parameters: 


pseudo dev: 


real dev: 


DOUBLE 


SINGLE 


NONE 


CHARACTER 


fa 


specifies the pseudo device or real device to 
which the BANNER command specifications 
pertain. 


specifies that two banner pages are to be 
produced for each file output on the specified 
device. 


specifies that one banner page is to be 
produced for each file output on the specified 
device. 


specifies that no banner page is to be 
produced for each file output on the specified 
device. This option is useful for very slow 
printing devices, card punches, or _ printers 
using preprinted forms. 


Character specifies a single ASCII character 
that the spooler will use to print the 
contents of the BANNER pages. The default is 
the letter O. 


is the file descriptor of an information file 
that contains any combination of the following 


six keywords. The user has’ the option to 
select up to five of these keywords and 
include them in the file. These keywords 


signify the information to be printed on the 
BANNER pages. 
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FD formats the filename. 


AC formats the user account number. 

TASKNAME formats the task name. 

DATE formats the date. 

TIME formats the time of day. 

LOGO='text' formats a 1- to 12-character 
user-defined text record. The 


text record must be contained 
within the quotation marks. 


The user has the option to select up to five 
of the above keywords and include them in the 
file. These keywords signify the information 
to be printeci on the BANNER pages. 


Functional Details: 


The default condition is a one page banner for a pseudo or real 
device with the following information: 


e@ Filename 

e Account number 

e Taskname 

e® Date 

e Time 

If the BANNER command is directed to a pseudo device; the 
specifications in the command apply to all real devices 
associated with that pseudo device. If a real device is 
associated with two or more pseudo devices, the latest BANNER 
command entered for any of the pseudo devices will apply to the 
real device. This command is only valid from a primary control 


unit or a secondary control unit for the pseudo device associated 
with the secondary AID. 
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In addition to the 132-column BANNER output, an information block 
is output with each file. This information block contains’ the 
following information: 

@® Full filename 

e User account number 

e Date and time the file was placed on the spool queue 

# Date and time the file was output 

e The physical output device 


e ‘The pseudo device name 
Example: 
BANNER PRN1:,S,CHARACTER=A 
All output on device PRN1: will be output with single 


page banners containing the default information set. The 
BANNER page contents will be printed using the letter A. 
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6.4 BLOCK COMMAND 


The BLOCK command is used to display the current physical data 
block size and index block size or to set the default values for 
these two parameters. 


Format: 
BLOCK blksize/indexsize 
Parameters: 
blksize is a decimal number indicating the data block 
size in 256-byte sectors. 
indexsize is a decimal number indicating the index block 
size in 256-byte sectors. 


Functional Details: 


The BLOCK command can be used to display or set the data block 
size and index block size, in 256-byte sectors, for buffering and 
debuffering operations on spool files. To display the current 
values, BLOCK is entered without any additional parameters. To 
set the default block size (data and/or index) or change the 
current values, the blksize/indexsize parameters are used with 


the BLOCK command. When setting new values, do not exceed the 
maximum block size established at system generation (sysgen). 
The default value is one sector. Primary control unit 


authorization is required to set the data and index block sizes. 
Secondary and user-level control unit authority may display the 
current data and index block sizes. 
Examples: 
BLOCK 5/3 
The default data block size for the allocation of spool 
files is 5, the default index blocking factor is 3. 


BLOCK 


The current data block size and index block size will be 
displayed. 
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6.5 CHANGE COMMAND 


The CHANGE command is used to modify the characteristics of a 
spool file which is currently residing on the spool queue. 


rormat: 


CHANGE fd DEVICE=pseud dev: [,COPIES=n][,FORM=formname][, PRIORITY: 


ee 


=e 


VFC 


Parameters: 


fd 


DEVICE 


COPIES 


FORM 


PRIORITY 


IMAGE or 
VFC 


i 


NOVFC 


NO — tomers | eeeos —- 


NODELETE NOQCHECKPOINT 


is the file descriptor (name) of the file to 
be modified. 


allows the pseudo device specification to _ be 
changed. 


allows a change in the number of copies to be 
output. 


allows preprinted forms specification to be 
changed. 


allows the output priority of a file to be 
altered. The capability of a user to alter 
the priority of a file is dependent upon the 
authorization level of that user. Primary 
authorization can change the priority of any 
file on the spool queue. Secondary 
authorization can change the priority of any 
file on the spool queue with the same 
secondary authorization identifier. User 
authorization can change the priority of files 
that the user placed on the spool queue. 


allows a change in the output format of a 
file; either output in IMAGE (as is) or with 
VFC (vertical forms control). These 
parameters are mutually exclusive. 
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| 
RELEASE. 


NO IMAGE allows a change to the output format of a 

or NOVFC file; either turns VFC off or resets the image 
option. These parameters are mutually 
exclusive. 


DELETE or allows a change to the handling of a file 

NODELETE after output; if the file was allocated by the 
spooler, the default is DELETE. If the file 
is a standard user file, the default is 
NODELETE . 


CHECKPOINT or turns on or off checkpointing for a given 

NOCHECKPOINT file. If global checkpointing is not’ turned 
on in the spooling environment no 
checkpointing takes place. These parameters 
are mutually exclusive. 


HOLD causes a print request to be held on the 
queue. Request is held until a REI.EASE is 
issued. 

RELEASE enables a print request which has been held to 


become available for output. 


Functional Details: 


[f two conflicting parameters are entered in a CHANGE command, 
the default prevails. The CHANGE command is available to all 
authority levels. 


Example: 
CHANGE M300:REPORT.LST/5, HOLD, VFC 
The file M300:REPORT.LST/5 is placed in a hold state. It. 


will be output with vertical forms control (VFC) when a 
RELEASE command enables the file to be output. 
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6.6 CHECKPOINT COMMAND 


The CHECKPOINT command is used to set or display the checkpoint 
value. When set ON, each file placed on the queue will have an 
associated record number that is updated after every N_ records 
have been output. 


Format: 
| ON, N 
CHECKPOINT 
OFF 
Parameters: 
ON turns the checkpoint option on and sets N_ as 
the number of records’ to be output between 
queue updates. N must be a number between 1 
and 2,147,483,647. 
NOTE 
A disk I/O is performed at each 
checkpoint, therefore, setting N 
to a very small number may degrade 
spooler and system performance. 
OFF turns the checkpoint option off. This is the 


default condition. 


Functional Details: 


Checkpointing is a recovery procedure that provides the 
capability to restart spooling at the point where it stopped 
after a failure by Keeping a record number pointer for each file 
in the queue. This avoids redundant output of already printed 
data and is especially useful when outputting very large files. 
As a file is output, the record number in the spool queue is 


updated to follow the progress of the file being output. As a 
result, when the spooler is restarted after a system failure, 
output can be requested to begin from the last record 


checkpointed instead of returning to the beginning of the file. 
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Only the primary control unit can set N in the CHECKPOINT ON 
command. However, any user may enter CHECKPOINT without optional 
parameters to display the current value of N. 

The user can turn checkKpointing on or off on a file-by-file basis 


via the CHECKPOINT option of the PRINT, PUNCH, CHANGE, or 
SPOOLFIILE commands. 


Examples: 
CHECKPOINT ON, 80 
Sets checkpointing feature on. Every 80 records output 


will result in a queue update. 


CHECKPOINT 


Displays the current checkpoint number. 
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6.7 CREATE COMMAND 


The CREATE command is used to define and initiate pseudo 
device(s) in the spooler environment. 


Format: 


CREATE pseud devi: [,...pseud dev20:] 


Parameters: 


pseud devl: 
pseud dev20: 


Functional Details: 


The CREATE command 


is the 1- to 4-character name of the pseudo 


device to be created. The first character 
must be alphabetic and the remaining 
characters alphanumeric. The pseudo device 
cannot already exist in the spooler 


environment. Up to 20 pseudo device names can 
appear in a single CREATE command. 


is used to define a pseudo device that is then 


available for use in the ASSIGN, PRINT, PUNCH, GROUP, and ATTACH 
commands. Primary control unit authority is required to create 


pseudo devices. 


[f a user wants to 
currently present 
DEVICES command is 


Manual for details. 


Example: 


display the names of the pseudo devices 
in the spooling environment, the DISPLAY 
available. See the OS/32 Operator Reference 


CREATE PR1:,PR2: 


Creates two pseudo devices, PRl: and PR2:. 
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6.8 CTASK COMMAND 


The CTASK command is used to add or remove a task or _ tasks, 
called control tasks, which are capable of having a dialogue with 
the spooler and to display all such control tasks in the spooler 
environment. 


Format: 
INCLUDE taskl ,...,task10 
CTASK 
REMOVE task2 ,...,task10 
Parameters: 
INCLUDE is the keyword used to add a control task to 
the spooler environment. 
REMOVE is the keyword used to remove a control task 
from the spooler environment. 
taskl identifies the specific control task(s) to be 
{taskl10] added or removed from the spooler environment. 


If a task is to be added to the spooler 
environment, it must first be loaded into 
memory using the LOAD command. 


Functional Details: 


If the CTASK command is entered without parameters, all control 
tasks in the spooling environment are displayed. The CTASK 
command can be used to manipulate the number of control tasks in 


the spooler environment. Control tasks are able to havea 
Gialogue relationship to the spooler; i.e., able to send and 
receive messages from the spooler. If a control task having one 


or more subcontrol tasks associated with it is removed from the 
spooler environment (see SCTASK command), the subcontrol tasks 
are also removed. 

If the primary control task is removed from the spooling 
environment, the following message is generated: 


PRIMARY CTASK WAS CANCELLED 
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The default primary control task .SPL is then loaded asthe 
primary control task. 


If the default primary control task .SPL is removed, the message 


shown above is generated and then the default primary control 
task .SPL is automatically reloaded by the spooler. 


Examples: 


CTASK INCLUDE T1,T2 


Establishes the tasks Tl and T2 as control tasks. 


CTASK REMOVE T2 


Removes control task T2 from the spooler environment. 
Any subcontrol tasks associated with T2 would be removed 
at this time. 
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6.9 DELETE COMMAND 


The DELETE command is used to remove a pseudo device(s) and/or a 
physical device(s) from the spooler environment. 
Format: 


devl: ,...,pseud et 
DELETE 


real devl: ,...,real dev20: 


Parameters: 


pseud devl: identify the pseudo devices to he 
,.-..,pseud dev20: removed. 
real devl: identify the real devices to he 
,---,real dev20: removed. 


Functional Details: 


Up to 20 devices, pseudo, real, or a combination of the two may 
be specified in a single DELETE command. When a pseudo device is 
removed, its association with a real device (or devices) is 
deleted. Subsequent assignments to the pseudo device will be 
rejected, but current assignments to the pseudo device are 


allowed to complete. When a real device is deleted, its 
association with a pseudo device(s) is broken. Output on the 
deleted real device will be allowed to complete. Secondary and 
user control units are not able to execute this command. It is 


valid from a primary control unit only. 


Example: 


DELETE PRN1:,PRN2: 


The pseudo devices PRN1: and PRN2: are deleted from the 
spooling environment. Ongoing I/O will proceed until 
completion, new assignments to these devices will be 
rejected. 
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6.10 DETACH COMMAND 


The DETACH command is used to break the association between a 
real device and a pseudo device as established through the ATTACH 
command. 


Format: 


DETACH PDEVICE=pseud dev RDEVICE=real devi: [,...real dev19:] 


Parameters: 
pseud dev: is the name of the pseudo device the _ real 
device is to be detached from. 
real devl: is the name of the real device to be detached. 
,-e..real 
devl9: 


Functional Details: 


The DETACH command dissolves the logical association between a 
pseudo device and a real device. If the real device specified is 
not associated with any other pseudo device, the logical unit 
(lu) assigned to that real device is closed. However, if the 
real device is associated with other pseudo devices, these 
associations remain unaffected. 


Example: 
DETACH PD=PRN1 RD=PRT1,PRT2 


The real devices PRT1 and PRT2 are detached from pseudo 
device PRN1. 
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6.11 DEVICE COMMAND 


The DEVICE command is used to alter the status of a pseudo device 
or a physical device. 


Format: 


DEVICE 


Parameters: 


pseudo dev: 


RESTRICT 


FREE 


real dev: 
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pseudo device 


a 7 


name FREE 


IMMEDIATE 
, SUSPEND 
DELAYED 


real device FLINE=n 
name FPAGE=n 


,) BLINE=n 
BPAGE=n 
REWIND 
CONTINUE 


is the name of the pseudo device to which the 
command is directed. 


indicates that the real devices associated 
with the preceding pseudo device will only 
receive output if the pseudo device 1s 
expressly requested through the use of an 
assign call or by specifying the pseudo device 
in the ‘DEVICE=' parameter of a 
PRINT/PUNCH/CHANGE command. This parameter is 
valid only in reference to a pseudo device. 


resets the RESTRICT parameter condition. The 
pseudo device is used for output whenever it 
becomes available. This parameter is valid 


only in reference to a pseudo device. 


is the name of a real device to which the 
command is directed. 


SUSPEND 


FLINE 


F PAGE 


BLINE 


BPAGE 


REWIND 


causes the specified real device to suspend 
output. If the DELAYED option is included, 
the device will be suspended after the 
currently printing file has completed. If the 
IMMEDIATE option is included, the device will 
be suspended immediately. This is the default. 
option. 


NOTE 


This option must be used prior to 
using any of the following 
options. 


indicates to forward space a print file n 
lines. The real device to which the command 
is issued must be suspended before this 
parameter is used. Output will automatically 
resume on a paused device after the entry oft 
this parameter. The device need not be 
continued. 


indicates to forward space a print file n 
pages. If page length was not already defined 
in a FORM command, a default length of 66 
lines is assumed. Output will automatically 
resume on a paused device after the entry of 
this parameter. The device need not be 
cont inued. 


indicates to backward space a print file hn 
Lines. The real device to which this command 
is directed must be suspended before this 
parameter is used. Output will automatically 
resume on a paused device after the entry of 
this parameter. The device need not be 
continued. 


indicates to backward space a print file n 
pages. Page length conventions are the same 
as explained above for the FPAGE command. 
Output will automatically resume on a paused 
Gevice after the entry of this parameter. The 
device need not be continued. 


this causes the file currently spooling on the 
specified real device to be rewound and 
brought to the beginning of file, where 
spooling continues. Output will automatically 
resume on a paused device after the entry of 
this parameter. The device need not he 
continued. 
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NOTE 


The file positioning parameters 
FLINE, FPAGE, BLINE, BPAGE, and 
REWIND can only be used when a 
file is actually being output. 
These parameters have no affect 
when entered while a Banner or 
Trailer page is being output, and 
if entered at that time they are 
ignored and no error message is 
generated. 


CONTINUE restarts a suspended device. If a file was 
being spooled when the device was suspended, 
the next record in the file being spooled is 


processed. 
Functional Details: 
The DEVICE command requires primary Or secondary level 
authorization. The DEVICE command enables orderly halting of 


spooled devices to correct paper jams, change forms and bypass 
printing long documents when only a few pages are needed. 


Example: 


DEVICE PRT1L: ,SUSPEND 


The output of a file om device PRTL: is temporarily 
suspended. 


DEVICE PRTL: , REWIND 


The file being output on device PRTI: when it was 
suspended is rewound to the beginning of file and output 
is resumed. 
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6.12 END COMMAND 


The END command is used to end spooling either immediately or 
after files currently on the spool queue are output. 


rormat: 
DELAYED 
END 
IMMEDIATE 
Parameters: 

DELAYED causes spooler functions to end after all 
currently printing files are output. No new 
print or assignment requests are accepted. 
This option is also the default. 

IMMEDIATE causes spooler functions to cease and all 


pseudo devices and real devices to be released 
immediately. 


Functional Details: 


The END command is only valid from a primary control unit. 
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6.13 FLUSH COMMAND 


The FLUSH command is used to: 


e delete a file from the spool queue, 


e delete a file from the spool queue and from disk in one 
operation, or 


e stop the output of a file on a specified device. 


Format: 


fd [, DELETE | 
FLUSH 
real device: 


Parameters: 


fd is the name of the file to be removed from the 
spool queue. If the file is not a spool file 
(allocated by SPL/32), it is not deleted from 
disk. If the file is a spool file (that is 
allocated by the SPL/32), it is automatically 
deleted from disk. 


DELETE specifies that the file is to be deleted from 
disk after it is removed from the spool queue 
regardless o€ whether it was allocated by 
SPL/32 or not. If the file is currently being 
output, it will not be deleted from disk. 


real device: is the name of a real device. The file being 


output on this device is removed from the 
spool queue and output ceases immediately. 


Functional Details: 


The FLUSH dev: option requires primary or secondary level 
authorization. A user can only FLUSH files which originated from 
that user and then must use the FLUSH fd option. 
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Examples: 


FLUSH M300:REPORT.LST/5,DEL 


File M300:REPORT.LST in account 5 is removed from the 


spool queue. The file is also deleted from disk unless 
the file is currently being output. 


FLUSH PRTIL: 


The file currently being printed on PRT1: is stopped and 
removed from the spool queue. The file is deleted from 
disk if it was allocated by the spooler. Other file 
types are not deleted from disk. Only primary or 
secondary units can perform this operation. 
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6.14 FORM COMMAND 


The FORM command has three functions: 


e to declare valid form names, 


@ to show which forms are to be mounted on each of the printers, 


and 


e to display valid form names. 


Format: 


Parameters: 


INCLUDE 


PLENGTH 


BMARG IN 


TMARG IN 


PWIDTH 


REMOVE 
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PLENGTH=p PLENGTH=p 
INCLUDE frmi|) BMARGIN=b(|[- ..,£rm4]|) BMARGIN=b 
TMARG IN=t. TMARG I N=t. 
PWIDTH=pw PWIDTH=pw 


REMOVE frml [,-frm2_][,...,f£rm5] 


MOUNT frml[VERIFY=n ,devl:][,...,dev15:] 


is used to specify a valid form name (l- to 
8-characters long) for each unique paper type. 
The default form name is STD. Up to four 
forms can be included in a_e single command 
line. 


is the number of lines per page for the form 
specified in the INCLUDE command. Default is 
66 lines per page. 


is the number of blank lines to be left at the 
bottom of the page. Default is 5 lines. 


is the mumber of blank lines to be left at the 
top of the page. Default is 5 lines. 


is the number of print positions horizontally 
across the page. 


causes a currently valid form name to _ be 
removed from the list of valid form names. 


MOUNT this option of the FORM command is used to 
associate a particular form type with a 
particular printer. Subsequent output that 
requires that particular form can then be 
directed to the device that has the form 
mounted. 


VERIFY this option of the MOUNT parameter allows’ the 
user to specify that forms alignment is to be 
verified. The user can specify (in number of 
pages) at what point alignment should be 
verified. Output of the first file on the 
device will be suspended after n pages have 
been output. The operator can then verify 
forms alignment and continue the device, or 
realign the form, rewind to beginning of file, 
and resume output. 


CE by say is the device the FORM MOUNT command refers 
devl15S: to. Up to 15 devices can be specified in a 
single command line. 


Functional Details: 


The FORM command has three distinct functions dealing with 
printer paper control. The INCLUDE, REMOVE, and MOUNT keywords 
denote the functions available. INCLUDE enables new forms to be 
added to the system and format of these forms can be defined. 
REMOVE enables currently valid forms to be removed from system 
availability. MOUNT enables form mounting requests to be issued 
and verification of alignment of these forms to be requested. 
The FORM command is valid only when issued from a primary control 
unit or from a secondary control unit for the output device in 
question. Issuing a FORM command with no parameters results in 
forms information for all devices in the spooler environment to 
be displayed. Whenever a file is placed on the spool queue that 
requires a form not currently mounted on any device, the message: 


REQUEST PENDING FOR FORM: formname 


is generated. 
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Examples: 


FORM INCLUDE TWO (PL=70,TM=3,BM=4) ,CHKS(PL=62) , BLUE 


Three forms are defined in this example: TWO, CHKS, and 
BLUE. TwO is further defined to have a page length of 
70, top margin of 3, and bottom margin of 4 lines. CHKS 
is further defined to have a page length of 62 lines and 
default top and bottom margins. BLUE has default 
characteristics for page length, page width, and top and 
bottom margin sizes. 


FORM MOUNT=TWO, PRT1: /VE=2 
The spooler is notified that form type TWO is mounted on 


device PRT1:. The device will be paused after two pages 
have been output so that forms alignment can be verified. 
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6.15 GLOBAL COMMAND 


The GLOBAL command is used to define the global or default pseudo 
device name or to display the current global pseudo device name. 


Format: 


GLOBAL pseud dev: 


Parameter: 


pseud dev: specifies a l- to 4-character alphanumeric 
name (first character must be alphabetic) of 
the pseudo device to be assigned as the global 
pseudo device. 


Functional Details: 


The GLOBAL command is valid when issued from the primary control 
unit when defining a new global pseudo device. Issuing a GLOBAL 
command with no pseudo device name causes the current global 
pseudo device name to be displayed. PR: is the default global 
pseudo device. 


Example: 


GLOBAL PRI: 


The global pseudo device name becomes PRIL:. 
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6.16 GROUP COMMAND 


The GROUP command is used to establish a logical relationship 
between a number of units (terminals or tasks) and a pseudo 
device, and to assign a default print location for the members of 
this logical relationship. 


Format: 


INCLUDE origin idl ,...,origin idl9 
GROUP PDEVICE=pseud devl 


REMOVE origin idl ,...,origin idl9 
Parameters: 


pseud devl is an already existing pseudo device name. 


INCLUDE denotes that the default print location for 
the members of the group will be the preceding 
pseudo device. 


REMOVE allows a specified member or members of the 
group to be dissassociated from the preceding 
pseudo device as the default print location. 


origin idl: is a unique l- to 8-character identifier for 
pseeyOLigin a task or location (terminal). 
idl9 


Functional Details: 


Once an origin is assigned to a group, that origin can no longer 
assign output to the system global pseudo device. Any assignment 
to the global system pseudo device is translated by the spooler 
to an assignment to the group's default pseudo device. A unit 
may be associated with one group only, meaning it can have only 
one default print location. The GROUP command may be_ used 
without the INCLUDE or REMOVE keywords, the resulting output will 
detail the units grouped with the pseudo device. If a primary 
control unit issues the GROUP command alone without any 
parameters, each pseudo device with its associated group units 
will be displayed. If a secondary or user control unit issues 
the GROUP command without any parameters, the units in its group 
will be displayed. 
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Examples: 


GROUP PDEVICE=PR1: INCLUDE CRT1: , TASKABCD 


The task TASKABCD and the terminal CRT1: are associated 


with pseudo device PRl:. Therefore, their default print 
location is the real device associated with pseudo device 
PRi:. 


GROUP PDEVICE=PR2: INCLUDE CRT1: , TASKABCD 


GROUP PDEVICE=PR2: REMOVE TASKABCD 
GROUP PDEVICE=PR2: INCLUDE CRT4: 


In this example, different terminals and tasks' under 
different control tasks are assigned the same default 
print location, pseudo device PR2:. First, terminal 
CRT1: and task TASKABCD are associated with PR2:. Then 
TASKABCD is removed from the group whose default print 
location is the real device associated with pseudo device 
PR2:. Finally, terminal CRT4: is included in the group 
with a default pseudo device of PR2:. 
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6.17 INPUT COMMANDO 


The INPUT command is used to specify, remove, or display input 
spooling devices. 


Format: 


CTASK=taskname [INCLUDE cr1l:][...,cr8:] 
INPUT 


REMOVE crl: [..,cr8:] 


Parameters: 


taskname specifies the control task that is to receive 
attention messages generated by the specified 
input devices. 


INCLUDE assigns the specified devices to input 
spooling. 
REMOVE removes the specified devices from input 
spooling. 
crl: identifies the input device(s) to be assigned 
--CLa: or removed from input spooling. 


Functional Details: 


If the control task is omitted from the INPUT command, the 
control task monitoring the device which entered the INPUT 
command will receive attention messages generated by the INCLUDE 
input devices. The INPUT command, when used to include or remove 
input devices, is only valid from the primary control unit. Any 
user may use the INPUT command without parameters to display the 
input devices in the spooler environment. 
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Example: 


INPUT CTASK=CTASK1 INCLUDE CR1:,CR2: 
Card input devices CRl: and CR2: are assigned to input 


spooling. The control task CTASK1 will receive any 
attention messages pertaining to CR1l: and CR2:. 
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6.18 INTERROGATE COMMAND 


The INTERROGATE command is used to display information pertaining 
to the spool queue or to display the current configuration of the 
spooler environment. 


Format: 


INTERROGATE 


Parameters: 


QUEUE 


PD 


FORM 


FD 
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QUEUE fc 
PD pda: 

FORM formname 
FD filename 


CONF IGURATION 


provides the following information about 
user's queued files: 


print priority 

filename 

number of copies requested 

pseudo device name 

form name specified 

options (VFC, IMAGE, CHECKPOINT, 
DELETE , HOLD) 


displays the same information as described 
above for all files on the queue that are 
assigned to the specified pseudo device. 


displa,s the same information as described 
above for all files on the queue that 
requested the form name specified. 


displays the same information as described 
above for the specific filename’ specified 
here. 


CONFIGURATION displays the following information about all 
physical devices on the spooler: 


status 

current form mounted 
currently printing file 
associated pseudo devices 


Functional Details: 


If no parameters are entered with an INTERROGATE command, all 
spool queue file information and the spooler device configuration 
will be displayed. 


The output of an INTERROGATE command is dependent upon the 
authority level of the user who initiated the command. An 
INTERROGATE command issued from a primary control unit will 
display information for the system-wide spooler environment. An 
INTERROGATE command issued from a secondary control unit will 
display information pertinent to devices associated with that 
secondary control unit. An INTERROGATE command issued from a 
user authority level will display information pertinent to that 
user's account. 


Examples: 


INTERROGATE QUEUE 
This example requests that all of the user's files on the 


queue be displayed with associated information about each 
file as described in the QUEUE parameter explanation. 


INTERROGATE FORM CHECKS 


This example requests that all files on the queue that 
requested form name CHECKS be displayed. 
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6.19 PRIMARY COMMAND 


The PRIMARY command is used to define the authorization 
identifier (AID) for the primary control origin and to specify 
the control task from which commands requiring the primary level 
of authorization will be accepted. 


Format: 


PRIMARY ctask/aid 


Parameters: 


ctask is the control task that is to become a 
primary control unit. 


aid is the identifier name or code that will 
accompany all communications that require the 
primary level of authorization. A unit 


assigned to or monitored by the control task 
specified in the PRIMARY command that uses the 
AID specified in the PRIMARY command will have 
primary control privileges. 


Functional Details: 


The task .SPL is the default primary control task and INITPAID is 
the default AID. The primary control unit is the only valid user 
of the PRIMARY command to set or display the current AID or 
ctask. The following commands can only be executed from the 
primary control unit to set or specify: 


ATTACH DETACH QUEUE 
BLOCK GLOBAL QUIESCE 
CHECK GROUP SCTASK 
CREATE INPUT SECONDARY 
CTASK PRIMARY SPVOLUME 
DELETE PRIORITY 
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These commands are available to other authorization levels to 
display information only. If the PRIMARY command is entered 


without a parameter, the current primary task and AID are 
displayed. 


Example: 
Primary CT1/ABC 
This establishes the AID as ABC. Any command issued from 


a unit under control task CTl with ABC as the AID has 
primary authorization privileges. 
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6.20 PRINT COMMAND 


The PRINT command is used to assign a file for output on a 


printing device. 


Format: 


PRINT fd [,DEVICE=pseud dev:] [,COPIES=n] [,FORM=formname] | 


heme t ee | Ce 


NOVFC 


Parameters: 


fda 


DEVICE 


COPIES 


FORM 


IMAGE or VFC 
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VFC 


[, PRIORITY=p] 


DELETE CHECKPOINT 


is the name of the file to be printed. This 
is a required parameter. 


identifies a pseudo device associated with the 


desired physical output device. If omitted, 
the spooler determines a default print 
location. 


n specifies the number of copies to be output. 
Must be in the range of 1 to 255. If omitted, 
one copy will be output. 


specifies that the file is to be output on a 
special preprinted form. If the specified 
form name was not previously declared using a 
FORM command, an error message is generated 
and the print request is output using the 
default form name STD. 


specifies that the file is to be output with 
vertical forms control (VFC) or in image 


format (IMAGE). With the VFC option, the 
first character of each 80-byte record is read 
as a carriage control character. These 


commands are mutually exclusive. 


IMAGE 


| 


NOIMAGE or specifies that the VFC option is to be reset 
NOVFC and the file is to be output without vertical 
forms control (NOVFC) or that the IMAGE option 
is to be reset and the file is to be output 


with VFC. 

NODELETE resets the DELETE option. The file is not 
deleted after output. This is the default. 
option for standard user files output by the 
spooler. 

DELETE specifies the file can be deleted after 


output. This is the default for files created 
by the spooler through an ASSIGN or SPOOLFIILE 
command. 


NOCHECKPOINT turns off checkpointing for this file. 

CHECKPOINT turns on checkpointing for this file. This is 
the default option. The global checkpoint 
option must be on. 

PRIORITY p is the print priority of this file. p is a 


number from 1 to 240 with the Lower number 
having a higher print priority. 


Functional Details: 


If two conflicting parameters are entered in a print request, 
such as DELETE and NODELETE, the default of the two is executed 
and an error message is sent. 


Example: 
PRINT M300:REPORT.LST/5,DEV=PRN1L: ,COP=3,F=FRM1 
Three copies of the file M300:REPORT.LST in account 5 are 


to be output on form FRM1l with pseudo device PRNL: 
specified as the destination. 
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6.21 PRIORITY COMMAND 


The PRIORITY command is used to set the default output priority 
or display the current default output priority of files on the 
queue. 


Format: 


PRLORITY number 


Parameter: 


number is a number from 1 to 255 that becomes’ the 
default priority for the spooling environment. 


Functional Details: 


Primary control unit authority is required to change the default 
priority with the PRIORITY command. Secondary control units and 
user control units can display the current default priority by 
entering the PRIORITY command with no option. If the PRIORITY 
command is entered without a new value, the current default 
output priority is displayed. 


Example: 
PRIORITY 240 


The default priority for print or punch requests becomes 
240. 
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6.22 PUNCH COMMANDO 


The PUNCH command is used to direct a user file to be output on 
a card punch device. 


Format: 


PUNCH fd[,DEVICE=pseud dev: ] [,COPIES=n][,FORM=form name] 


‘mers 


NODELETE 


Parameters: 


fd 


DEVICE= 


COP ITES= 


FORM= 


DELETE 


NODELETE 


CHECKPOINT 


ae 


[, PRIORITY=p] 
NOCHECKPOINT 


is the name of the file to be punched. This 
is a required parameter. 


identifies the pseudo device the file is 
assigned to for output. If omitted, the 
default punch location is determined by 
spooler. 


n is the number of copies to be output. n may 
range from 1 through 255. If this parameter 
is omitted, one copy is output. 


specifies that the file be output onto a 


special preprinted or prepunched card. If the 
specified form name was not previously 
declared using a FORM command, an error 


message is generated and the punch request is 
output using the default form name STD. 


specifies that the file be deleted after 
output. This is the default for files created 
by the spooler through an ASSIGN or SPOOLFIILE 
command. 


specifies that the file is not to be deleted 
after output. This is the default option for 
standard user files output by the spooler. 


CHECKPOINT turns on checkpointing for _ the 


specified punch file. This is the default 
condition. 
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NOCHECKPOINT resets the CHECKPOINT option to off. 


PRIORITY p is the priority of the punch request. 


Functional Details: 


If two conflicting parameters are entered in the same PUNCH 
command, the default parameter is executed and an error message 


is generated. This command is available to all authority levels 
in the spooling environment. 


Example: 


PUNCH M300:REPORT.LST/5,DEV=CRD1: , COP=3 , DELETE 


Three copies of the file M300:REPORT.LST in account 5 are 


to be output on pseudo device CRD1:. The file is to _ be 
deleted after output. 
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6.23 QUEUE COMMAND 


The QUEUE command is used to designate the file to be used as the 
system spool queue or to display the file currently performing 
this function. 


Format: 


QUEUE fd 


Parameter: 


fd specifies the file descriptor of the file to 
be used as the spool queue in the _ form 
VOLN:f ilename.ext/acct. 


Functional Details: 


The QUEUE command is generally issued during the START command. 
If it is omitted from the START command, SPL/32, by default, 
allocates a file named SPL32.QUE as the spool queue file. 
SPL32.QUE will reside on the first volume entered in a previous 
SPVOLUME command or, by default, on the system volume if no 
SPVOLUME command has been previously entered. If the allocation 
of the queue file on the system volume fails, the file is 
allocated on the TEMP volume. 


If the user wants to specify a new spool queue while the spooler 
is active, SPL/32 will finish outputting any file currently being 
output. Those entries waiting on the spool queue are not merged 
with the newly specified queue. 


A file specified as a queue file must either: 


@® not currently exist, or 


e must have been previously allocated as a queue file by the 
spooler. 


The QUEUE command alone, with no file descriptor parameter, can 
be used at any time to display the current spool queue filename. 
Primary control unit authority is required to specify the spool 
queue file. 
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Example: 


QUEUE M67B:SPLQUEUE.NEW 


File M67B:SPLQUEUE.NEW becomes the spool queue. If 
M67B:SPLQUEUE.NEW does not exist, it will be allocated 
and spooling will begin. If M67B:SPLQUEUE.NEW already 
exists, and it was previously allocated as a queue file 


by the spooler, it will be reused. 
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6.24 SCTASK COMMAND 


The SCTASK command is used to ada or remove subcontrol tasks in 


the spooling environment. These tasks are capable of sending 
commands to the spooler, and can selectively route spooler 
responses. Response messages to ae subcontrol command can be 


Girected to the control task that the subcontrol task is 
associated with or to the initiating subcontrol task itself. 


Format: 
CTASK=taskname [INCLUDE taskl,...,task/7] 
SCTASK 
REMOVE taskl [,...,task8] 
Parameters: 
taskname denotes the control task that can receive 
response messages from SPL/32 for the 
subcontrol tasks denoted in the INCLUDE option 
of this command. 
INCLUDE is the keyword used to add a_esubcontrol 
task(s) to the spooler environment. 
REMOVE is the keyword used to remove ae subcontrol 
task(s) from the spooler environment. 
taskl identifies the specific tasks to become 
r--.,task7 subcontrol tasks or to be removed from the 
r--.,task8 spooler environment. Up to seven tasks may be 


included in one SCTASK command and up to eight 
tasks may be removed in a single SCTASK 
command. 


Functional Details: 


This command, when used to add or remove tasks, is valid only 
from the primary control unit. All users are able to display a 
list of subcontrol tasks in the spooler environment by entering 
the SCTASK command without parameters. 
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Examples: 


SCTASK CTASK=T1l INCLUDE T2,T3 
Establishes the tasks T2 and T3 as_ subcontrol 
Responses to commands issued by these tasks 
directed to the control task Tl. 

SCTASK REMOVE T2 


Subcontrol task T2 is removed from the 
environment. 
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6.25 SECONDARY COMMAND 


The SECONDARY command is used to define an authorization 
identifier (AID) for a secondary control unit and/or to display 
all secondary AIDs in the spooler's environment. 


Format: 


SECONDARY ctask/aid,pd: 


Parameters: 

ctask is the control task which will receive all 
attention messages for any device associated 
with the specified pseudo device pd:. This 
task will be notified of the AID selected in 
this command. 

aid is the authorization identifier which will 
accompany all commands’ sent’ to the spooler 
with secondary authority. 

pd: is the pseudo device to which the _ specified 


aid applies. 


Functional Details: 


This command identifies a control task, a secondary level AID, 
and a pseudo device. The pseudo device must be created prior to 
its use in this command. Commands received by the spooler which 
affect pd: must have the specified secondary AID or a primary 
AID to be valid. This command is valid from the primary control 
unit only. When entered without options, all secondary AIDs in 
the spooling environment will be displayed. 


Example: 


SEC CTASK1/XYZ,PR2: 


The pseudo device PR2: has the secondary AID XYZ. Any 
command issued to control devices associated with PR2: 
must have XYZ as their AID. I/O error messages generated 
by the physical device associated with PR2: will be 
directed to CTASK1. 
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6.26 SPOOLFILE COMMAND 


The SPOOLFILE command allows a user to allocate a spool file on 
behalf of a specified pseudo device and assign that file toa 
specified lu of the currently selected task. This command makes 
all spooling options available at a terminal or command 
substitution system (CSS) level. This command is not processed 
by SPL/32 as a spooler command. It is handled by the operating 
system and the multi-terminal monitor (MTM). 


Format: 
VFC 
SPOOLFILE lu&lul,pseud dev,FORM=formname ’ 
IMAGE 
NO IMAGE CHECKPOINT HOLD 
; [COPIES=n]_ |, 
NOVFC NOCHECKPOINT RELEASE 
DELETE 
[,BLOCK= blocksize/indexsize] |, [, PRIORITY=p] 
NODELETE 


Parameters: 


Lu is a decimal number specifying the logical 
unit to which the pseudo device is to be 
assigned. 

lul indicates that lu is to be assigned to the 
same spool file as lul. lull must be the first 


lu assigned to the spool file. 


pseud dev is the 1- to 4-character name of a pseudo 
device. The first character must be 
alphabetic; the remaining alphanumeric. 


FORM= is a desired preprinted form name that can be 
specified here. If the form specified was not 
previously enabled using a FORM command, an 
error message is sent to the monitor ing 
control or subcontrol task and the request is 
processed using the default standard form 
name, STD. 
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VFC 


NOVFC 


COP ILES= 


HOLD 


RELEASE 


BLOCK 


blocksize 


indexsize 


DELETE 


NODELETE 


PRIORITY=p 


specifies the use of vertical forms’ control 
for the assigned lu. When VFC is used, the 
first character of each record is’ interpreted 
as a vertical forms control character. If VFC 
is not included, there is no vertical forms 
control for the device assigned to the 
specified lu. 


turns the vertical forms control option off 
for the assigned lu. This is the default 
option. 


identifies the number of copies to be output. 
It must be between 1 and 255 or an error 
message is sent. 


causes the specified file to remain on the 
spool queue until a RELEASE request is issued. 


enables a spool file for output when the lu is 
closed. 


specifies the index and/or data block size. 


is a decimal number specifying the physical 
block size in 256-byte sectors, to be used for 
buffering and debuffering operations involving 
the file. The default size is 1 or the value 
entered using the BLOCK command. If this 
value exceeds the max imum block size 
established at sysgen time, an error will be 
printed when attempting to allocate the file. 


is a decimal number specifying the index block 
size in 256-byte sectors. The default size is 
l1 or the value entered using the BLOCK 
command. Index size cannot exceed the maximum 
index block size established at sysgen time or 
an error will occur when attempting to 
allocate the file. 


the file is deleted after output. This is the 
default option. 


the file is not deleted after output. 
p is the desired print priority. If this 
option is not specified, the priority of the 


task the spool file assign is on behalf of 
becomes the print priority. 
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Functional Details: 


The SPOOLFILE command can be used to make an assignment to a 
pseudo device from the terminal or CSS level. If two conflicting 
parameters are entered in a single SPOOLFILE command, such as 
DELETE and NODELETE, the second parameter is executed and an 
error message is generated. The SPOOLFILE command is primarily 
for users operating in an MTM environment. 


Example: 


SPOOLFILE 4,pdad1:,VFC,DELETE 


This example causes a spool file to be allocated for 
pseudo device pdl: and assigns that file to logical unit 
4 of the current task. Vertical forms control has been 
specified for the specified lu and the DELETE option has 
been selected which means the file will be deleted after 
output. 
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6.27 SPVOLUME COMMAND 
The SPVOLUME command is used to designate new spool volumes, 


remove current spool volumes, or to display the spool volumes 
currently in use on the system. 


Format: 


INCLUDE volumel ? -+-7VO lume20] 
SPVOLUME 
REMOVE volumel [, -2e7VO lume20] 
Parameters: 
INCLUDE is used to designate new spool volumes. 
REMOVE is used to designate spool volumes to be 
disassociated with the spooling function. 
volumel designates the name(s) of the disk volume(s) 
,---r,volume20 to which the INCLUDE or REMOVE parameters 


refer. The name is’ one to four characters 
long. The first character must be alphabetic 
and the remaining alphanumeric. 


Functional Details: 


The SPVOLUME command's function is dependent on the _ user's 


authorization level. Primary control unit authorization is 
necessary to add or remove disk volumes in the spooling 
environment. Primary, secondary, and user control units are able 


to DISPLAY what disk volumes are currently being used for the 
spooling function by entering the SPVOLUME command without 
options. 


Files being spooled (output and input) without a specific volume 
designated are allocated by the spooler on the spool volumes on 
a round-robin basis so that no particular spool volume gets a 
disproportionate number of spool files. This applies to systems 
utilizing multiple spool volumes. 
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Examples: 


SPVOLUME INCLUDE M300,M301 


Disk volumes M300 and M301 are now available for 
allocation of spool files. 


SPVOLUME REMOVE M300 


Disk volume M300 is no longer available for 
allocation of spool files. 


SPVOLUME 


Displays the spooled disks currently on the system. 
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the 


the 


6,28 TRAILER COMMAND 


The TRAILER command is used to specify the number of trailing 
identification page(s) to be output with each file on a specified 
pseudo or real device and, to format the contents of this 
identification page(s) to suit users needs. 


Format: 
TRAILER 


Parameters: 


pseudo dev: 
real dev: 


DOUBLE 
SINGLE 
NONE 


CHARACTER 


fd 


pseudo dev: 


real dev: 


DOUBLE 
i SINGLE>|[, CHARACTER=character | [,fd] 


NONE 


specifies the pseudo device or real device to 
which the TRAILER command applies. 


specifies that two trailer pages are to be 
produced for each file output on the specified 
device. 


specifies that one trailer page is to be 
produced for each file output on the specified 
device. 


specifies that no trailer page is to be 
produced for each file output on the specified 
device. This option is useful for very slow 
printing devices, card punches, or printers 
formatting very large files. 


character specifies a single ASCII character 
that the spooler will use to print the 
contents of the TRAILER page. The default is 
the letter O. 


is the file descriptor of an information file 
that contains any combination of the following 
six keywords. 
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FD formats the filename. 


AC formats the user account number. 

TASKNAME formats the task name. 

DATE formats the date. 

TIME formats the time of day. 

LOGO='text' formats a 1- to 12-character 
user-defined text record. The 


test record must be contained 
within the quotation marks. 


The user has the option to select up to five 
of the above Keywords and include them in the 
file. These keywords signify the information 
to be printed on the TRAILER pages. 


Functional Details: 


The default condition is a one page trailer for a pseudo or real 
device with the following information: 


e Filename 

@® Account number 

e Task name 

e Date 

e® Time 

If the TRAILER command is directed to a pseudo device, the 
specifications in the command apply to all real devices 
associated with the pseudo device. If a real device is 
associated with two or more pseudo devices, the latest TRAII.ER 
command entered for any of the pseudo devices will apply to the 
real device. This command is only valid from a primary control 


unit or a secondary control unit for pseudo device associated 
with the specified real device. 


48-056 FOO ROO 6-51 


In addition to the 132-column TRAILER output, an information 
block is output for each file. This information block contains 
the following information. 

e Full filename 

e User account number 

@e Date and time the file was placed on the spool queue 

# Date and time the file was output 

e The physical output device 


e Pseudo device name 
Example: 


TRAILER PRT1:,D, CHARACTER=A 


Output from device PRT1: will be printed with two 
trailer pages containing the default information set. 
The contents of the TRAILER page will be printed using 
the letter A. 
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APPENDIX A 
SPL/32 COMMAND SUMMARY 


AI'TACH PDEVICE=dev RDEVICE=devl[,dev2 ... ,devl19] 
DOUBLE 
pseudo dev: 
BANNER ,< SINGLE [, CHARACTER=character [fd] 
real dev: 


NONE 


BLOCK blksize/indexsize 


CHANGE fd DEVICE=pseud dev: [,COQPIES=n ] [, FORM=formname] [, PRIORITY=n ] 
oe: ee . ; Poe nen HOLD 
VFC NOVFC NODELETE NOCHECKPOINT ae 


ON,N 
CHECKPOINT 
OFF 


CREATE pseud devl:[,...pseud dev20:] 


INCLUDE taskl ,...,taskl10 
CTASK 
REMOVE task2 ,...,task10 
pseud devl: ,...,pseud dev20: 
real devl: ,...,real dev20: 


DETACH PDEVICE=pseud dev RDEVICE=real devil: [,..-.real dev19:] 
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RESTRICT 
pseudo device |, 


name FREE 
ian, 
, SUSPEND 
eee 
DEVICE 
real device FLINE=n 
name FPAGE={n 
,) BLINE=n 
BPAGE=n 
REWIND 
CONT INUE 
DELAYED 
o eer 
JMMEDIATE 
fda [, DELETE | 
FLUSH 
real device: 
PLENGTH=p PLENGTH=p 
INCLUDE frm1}|)BMARGIN=bl(/[. ..,£rm4]|)BMARGIN=b 
TMARG IN=t TMARG IN=t 
FORM PWIDTH=pw PWIDTH=pw 


REMOVE frml [,frm2][,...,f£rm5] 


MOUNT frml[VERIFY=n ,devl:] [,...,dev15;:] 
GLOBAL pseud dev: 


INCLUDE origin idl ,...,origin idl9 
GROUP PDEVICE=pseud devl 


REMOVE origin idl ,...,origin idl9 


CTASK=taskname[INCLUDE crl:]|[-..,cr8:] 
INPUT 
REMOVE crl: [...,cr8:] 
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QUEUE 

PD pda: 
INTERROGATE FORM formname 

FD filename 


CONF I GURATION 


PRIMARY ctask/aid 


IMAGE 
PRINT fd[,DEVICE=pseud dev:] [, COP IES=n | [, FORM=formname] 4 


VFC 


NOVFC 


Fp ! aang poaaieng 
| DELETE 


[, PRIORITY=p] 
CHECKPOINT 


PRIORITY number 


PUNCH fd [,DEVICE=pseud dev:] [,CQPIES=n][,FORM=form name] 


DELETE CHECKPOINT 
r [/ RRIORITY=p] 


NODELETE NOCHECKPOINT 
QUEUE fd 
CTASK=taskname[INCLUDE taskl ,task7] 
SCTASK : ; 
REMOVE taskl [,...,task8] 


SECONDARY ctask/aid,pd: 


VFC 
SPOOLFILE lu&lul,pseud dev, FORM=formname | 
| | IMAGE 
NOIMAGE CHECKPOINT ) | HOLD 
, [,COPIES=n]_ |, 
NOVFC NOCHECKPOINT' RELEASE 


DELETE 


[,BLOCK= blocksize/indexsize | \ [,RRIORITY=p] 


NODELETE 
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INCLUDE volumel[,..., volume20] 
SPYOLUME 


REMOVE volumel[,...,volume20] 
DOUBLE 
pseudo dev: 
TRAILER ,\SINGLE)|[, CHARACTER=character ] [,fd] 
real dev: 


NONE 
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APPENDIX 6 
SPL/32 COMMAND MESSAGE SUMMARY 


CANNOT COMMUNICATE WITH CTASK: ctask 


The specified control task is not present in the _ spooling 
environment or has gone to end of task. 


DEVICE ACTIVE: device name given 


A command requiring the specified device to be in a suspended 
state was issued to an active device. 


DEVICE INACTIVE: device name given 


A command requiring the specified device to be in an active 
state was issued to an inactive device. 


DEVICE NOT INCLUDED: device name 


The specified device is not in the spooler environment. 
p 


DUPLICATE DEVICE: dev: 


The specified device name already exists in the _ spooler 
environment. 


DUPLICATE TASK NAME: task name 


The specified task already exists in the spooling 
environment. 


DUPLICATE UNIT NAME: unit id 
The specified unit name already exists and may not be used 
again. 

DUPLICATE VOLUME: volume name 


The specified volume is already assigned for the allocation 
of spool files. 
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FILE DESCRIPTOR ERROR: fd 


The file descriptor was syntactically incorrect. 


FILE NOT FOUND: fd 


The specified file was not found on the spool queue or in the 
disk directory. Check the filename. 


FORM NOT INCLUDED: formname 


The specified form has not been declared a valid form prior 
to use in a PRINT/PUNCH request. 


INVALID AUTHORIZATION-ID: authorization identifier 


The authorization ID specified in a PRIMARY or SECONDARY 
command is invalid. 


INVALID AUTHORIZATION LEVEL: authorization level 


The command attempted is not available to the _ specified 
authorization level. 


INVALID COMMAND: command 


Command is syntactically incorrect or is not a valid SPL/32 
commana. 


INVAILID CONTROL CARD 


A card deck with an incorrect control card was read. 


INVALID DATA BLOCK SIZE: blocksize 


The data block size specified exceeds the maximum established 
at sysgen time. 


INVALID DEVICE: dev: 


The specified device is not assigned to the spooler. 


INVALID FORM: form 


The specified form is not a valid form name. 
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INVALID INDEX BLOCK SIZE: i 


The index block size specified exceeds the max imum 
established at sysgen time. 


INVALID KEYWORD: keyword 


Keyword is syntactically incorrect or is not valid with the 
associated command. 


INVALID PARAMETER: parameter 


The specified parameter is not valid with the associated 
command. 


INVALID PRIORITY: priority 


The requested priority exceeds the maximum set at Link time, 
or the requested priority is outside the range of 10 to 249. 


INVALID SEPARATOR: separator 


The specified separator is invalid or is syntactically 
incorrect. 


INVALID TASK: taskname 


The specified taskname does not exist. 


INVALID VOLUME: vol: 


The specified volume is syntactically incorrect. 


I/O TASK WAS CANCELLED: I/O taskname 


The specified 1/0 task has been cancelled. 


MISSING CONTROL CARD 


A card deck without an initial control card was read. 


MISSING PARAMETER 


A required parameter is missing from the command. 
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NO AVAILABLE LUS 


There are no logical units available for use. 


NO SPOOL VOLUMES 


There are no spool volumes’ specified in the spooling 
environment. 


NO SUBCONTROL TASKS 


There are no subcontrol tasks in the spooling environment. 


NO [INPUT DEVICES 


There are no spooled card readers in the spooling 
environment. 


NO QUEUE ENTRIES 


There are presently no files in the spool queue. 


NO GROUPS 


There are currently no groups’ specified in the spooling 
environment. 


PRIMARY CTASK WAS CANCELLD: taskname 


The primary control task has been cancelled. 


PARAMETER CONFLICT: parameterl, parameter2 


Two mutually exclusive parameters are present. 


PRIVILEGE ERROR 


The access privilege mnemonic was syntactically incorrect. 
TASK NOT INCLUDED: taskKname 


The specified task was not included in the spooling 
environment. 
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UNIT NOT INCLUDED: unit id 


The specified unit was not included in the grouping request 
of a GROUP command. 


VERIFY COMPLETED ON: device name 


A request to verify forms alignment has been completed on the 
specified device. 


VOLUME NOT INCLUDED: volume name 


The specified volume was not included as a spool volume. 
VOLUME NOT IN SYSTEM: vol: 


The specified volume is not present in the system _ and 
therefore cannot be assigned as a spool volume. 
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APPENDIX C 
SPL/32 VS. SPOOLER COMMAND CORRELATION 


C.1 INTRODUCTION 


The following table correlates the SPL/32 command set with the 
Spooler command set as a guide for converting command 
substitution system (CSS) procedures. 


i + CORRESPONDING ; ' 
i SPL/32 H SPOOLER H ' 
H COMMAND H COMMAND ' COMMAND FUNCTION 1 
| FSS eee eu see EE eee see ee ree Ae ~ soar] 
i} ATTACH + START | Associates pseudo and physical jj; 
H } parameter } devices H 
! i i 4 
1 1 ' ; t 
| BANNER { OPTION i Defines the Banner page options } 
' 4 ' t 
t t ' ( 
| BLOCK i i Sets/displays index/data block |} 
H t i sizes H 
i ' H i 
| CHANGE Wh = i Changes output parameters of H 
! H ;} spool file ' 
t ' ' { 
! t i] ‘ 
| CHECKPOINT } : i Turns on/off/displays check- : 
| H | pointing i 
i i ' ' 
| CREATE i, -o* ‘| Creates pseudo devices H 
i i i i 
i CTASK i »* i Sets/displays control tasks i 
! ‘ : ' 
' i) i] i] 
} DELETE ! DELETE | Removes pseudo or physical i 
H i i devices from the spooling i 
H H } environment ' 
' ] ! ' 
1 i t ' 
{ DETACH i DELETE | Dissassociates physical and H 
i i | pseudo devices ' 
| i i i 
| DEVICE { OPTION {| Controls/displays device status | 
if i | H | 
| {-RESTRICT | | -PROTECT i Prevents use of device as H 
if i | } default ' 
, | i ot i I 
{ | ~FREE H {-NOPROTECT ;{ Enables use of device as de- H 
i 4 i H i fault i 
if i i i H 
| | -FLINE { | -FORWARD | Forward spaces a file n lines { 
i] ! i] 4 ' ' 
' ( i} t ' i} 
| {| -FPAGE H | -FORWARD | Forward spaces a file n pages H 
i 4 Lgl ! i 
| | -BLINE i i -BACKWARD | Backward spaces a file n lines | 
roy i 4 i i 
i | -BPAGE i | -BACKWARD i Backward spaces a file n pages | 
if i ' i ' 
| {-REWIND H | -REWIND | Rewinds a file ' 
i] ! { ! 1 i) 
' i} ' t 4 ' 
t {-CONTINUE  ; | -CONT INUE i Restarts a device if paused H 
i] ‘ 1 ! i] 4 
t { t i] 1 i 
| |-SUSPEND H { -SUSPEND | Pauses a device H 
i | i 4 i i 
i END i 2 | Ends spooler task H 
‘ ' ' t 
' i] ! t 
| FLUSH t+ CANCEL { Stops a file from heing output. } 
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SPL/32 
COMMAND 


FLUSH 


FORM 


GLOBAL 


GROUP 


INPUT 


INTERROGATE 


PRIMARY 


PRINT 
PRIORITY 
PUNCH 
QUEUE 


SCTASK 


SECONDARY 


SPOOLF ILE 


SPVOLUME 


CORRESPONDING } 
SPOOLER H 


COMMAND i COMMAND FUNCTION 


PURGE | Removes a file from the queue 


x 
names 


pseudo device 


START CARD 
INQUIRE 
tion 


tion identifier 


level 


Creates/displays valid form 
Specifies/displays global 


Sets/displays default print 
locations for logically grouped 
sets of terminals 

Defines input spool devices 


Displays spool queue informa- 


Defines the primary authoriza- 


Sets/displays default priority 
Punches a spool file 


Specifies file to be used as 
the spool queue 


Sets/displays subcontrol tasks 


Defines secondary level 
authorization identifier 


! 
| 
| 
i 
i 
{ 
i 
| 
1 
| 
{ 
1 
' 
i 
i 
i 
i 
i 
| 
H 
PRINT i Prints a spool file 
| 
{ 
t 
i] 
| 
H 
H 
' 
i 
i 
| 
H 
i 
| Makes SPL/32 features available 
{ level at the MIM terminal or CSS 
| 
{ 
| Sets/displays spool volumes 
t 
i 
' 
J 


Specifies trailer page options 


indicates no 
spooler 


command of similar function was 


available with 


~ connection indicates parameters of the SPL/32 DEVICE command 
(SPL/32) or the spooler OPTION command (Spooler) 
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APPENDIX D 
MESSAGE HANDLING 


D.1 INTRODUCTION 


This chapter provides a discussion of the messages and message 
handling procedures that SPL/32 uses to communicate with users 
and tasks within the spooling environment. The format of each 
type of spooler message is presented. The role of the uniform 
spooler control interface (USCI) is discussed. This chapter is 
presented primarily for the benefit of applications programmers 
who want to construct tasks that can function as control tasks 
within the spooling environment. These tasks must be able to 
communicate with the spooler and receive messages from the 
spooler in response. 


D.1.1 Message Overview 


Communication between the spooler and tasks consists of a_ series 
of dialogues. The task that issues the first message ina 
dialogue is the initiator. The initiator of a dialogue must 
assign a dialogue identifier that uniquely identifies where the 
dialogue initiated from. The dialogue identifier is then used to 
locate the initiator of the dialogue within the control tasks 
environment. In general, the structure of the messages used by 
SPL/32 is designed to allow control tasks, such as MTM, to access 
the contents of the message as necessary. Messages sent to the 
spooler from tasks/terminals consist of a 24-byte message buffer 
for SVC6 Send Data functions, a 44-byte SPL/32 message header, 
and an 80-byte ASCII record. This format allows commands to be 
entered and read directly from one 80-byte line on a terminal. 
Messages sent to tasks/terminals also use this format. This 
format allows the ASCII data to be displayed directly to a 
terminal or printer. 


D.2 THE UNIFORM SPOOLER CONTROL INTERFACE (USC!) 


The uniform spooler control interface (USCI) is the interface 
between control and subcontrol tasks and the spooler. The USCI 
accepts spooler commands and service requests from multiple 
concurrent tasks and if valid, submits them for execution. The 
USCI is designed to minimize spooler dependent code within tasks 
that use the spooler and to allow the spooler to be independent 
of the internal design of the tasks it communicates with. 
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D.2.1 Establishing Communication With the Spooler 


Only control and subcontrol tasks can communicate directly with 
the spooler. tn the case of control tasks, communication with 
the spooler is established when the spooler receives a request to 
designate a task as a control task. The request to create the 
control task is rejected and communication is not established if 
the task does not exist. If the task does exist, it is 
designated a control task and communication is established. In 
the case of subcontrol tasks, communication with the spooler is 
established when the subcontrol task is included. Both control 
and subcontrol tasks must be resident in the spooling environment 
and able to receive traps generated by an SVC6 send data request, 
in order to communicate with the spooler. 


If no control tasks are included in the spooling environment, the 
task .SPL is initially the default primary control task to allow 
communication between SPL/32 and the system console. It is 
cancelled when another primary control task is specified and 
accepted. 


D.2.2 Losing or Terminating Communication With a Task 


There are two conditions that can result in a loss of 
communication between a task and the spooler. 


e A control task goes to end of task (normal termination). 


e The spooler is unable to send a message to a_ control task 
(abnormal termination). 


D.2.2.1 Normal Termination of a Control Task 


The spooler intercepts any SVC3 issued by control tasks to 
ascertain when they no longer exist. If a control task goes to 
end of task while the spooler is running, the following actions 
are taken according to the task's level of authorization: 


e If the primary control task goes to end of task, the default 
primary control task .SPL, is loaded and given primary 
authorization. A message is sent to the system console 
indicating that the primary control task was’ cancelled. 
Subsequent attention messages generated by pseudo devices 
associated with the ending primary control task are directed 


to .SPL. Subcontrol tasks associated with the previous 
primary control task are removed from the spooling 
environment. 


® If a control task with secondary authorization goes to end of 


task, subsequent attention messages generated by pseudo 
devices associated with the ending task are sent to _ the 
primary control task. All subcontrol tasks associated with 


the ending task are removed from the spooling environment. 
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D.2.3 Response Routing (Spooler to Task) 


Spooler responses to control tasks and subcontrol tasks are 
routed in the following manner: 


@e Spooler responses to directives issued by control tasks are 
routed directly back to the issuing control task. 


@ Spooler responses to directives issued by subcontrol tasks can 
be selectively routed: 


l. The response can be routed back to the issuing subcontrol 
task. 


2. The response can be routed back to the control task 
monitoring the issuing subcontrol task. 


Message routing is specified by the routing flag byte (byte 64) 
in the message header preceding the message from the subcontrol 
task. A value of X'FF' in the routing flag byte causes responses 
to be routed back to the subcontrol task. A value of xX'O00O° in 
the routing flag bytes causes the message to be routed to the 
control task monitoring the subcontrol task. The spooler’ reads 
the routing flag byte for each message sent. This allows the 
message routing to be changed on a message by message basis, if 
so desired. 


D.2.4 Dialogue Termination 


The manner in which a dialogue between a control or  subcontrol 
task and the spooler is terminated depends on the initiating task 
in the dialogue and the type of message sent to initiate the 
dialogue. 


If a dialogue is initiated by a control task sending a command 
message, then it is terminated by the spooler with an exception 
or service message. 


An exception response message is sent if there is an error in the 
command, or if no service message is required and no error 
occurred. 


A service message is sent if there is no error and ae service 
message is required. 


A dialogue is not terminated until all message buffers have been 
received. 
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The mnemonic request initiates a dialogue and the mnemonic 
response terminates it. 


The attention message initiates and terminates a dialogue. 


The authority message is terminated when the control task returns 
an acceptance message in the case when the authority message is 
requesting acceptance, or the authority message terminates itself 


when it notifies the orginating control task of whether the 
transfer succeeded or failed. 


O.3 MESSAGE HEADER 


The message header is a 44-byte record that precedes each message 
received or issued by SPL/32. It contains identification 
information that notifies the spooler or a task about the 
initiator of the message and provides information about the type 
of message that follows. The format of a message header record 
is presented in Figure D-1l. 
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4004 0 (00) 


4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) DIALOGUE IDENTIFIER 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 


52 (34) MESSAGE TYPE 53(35) MESSAGE | 54(36) COMMAND [55(37) COMMAND 
ID SUBTYPE CODE 1D FUNCTION 


58 (4A 
56 (38) USER ACCOUNT ae GROUP ACCOUNT 


60 (3C) DEFAULT VOLUME 


64 (40) = ROUTING peey RESERVED 


MESSAGE BUFFER FOR SVC6 SEND DATA FUNCTION 


INITIATING TASK NAME 


eet 


ORIGIN IDENTIFIER (OID) 


AUTHORITY IDENTIFIER (AID) 


Figure D-l SPL/32 Message Header Record Format 
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Fields: 


MESSAGE BUFFER FOR 
SVC 6 SEND DATA FUNCTION 


DIALOGUE ID 


INITIATING TASK 


ORIGIN IDENTIFIER 


AUTHORITY [DENTIFIER 


MESSAGE TYPE ID 


the format of this field and a 
discussion of its use is presented 
in the 0S/32 Supervisor Call (SVC) 
Reference Manual. 


contains a unique identifier within 
the task that initiated the 
dialogue. The contents of this 
field are used to identify the 
message being responded to. 


contains the name of the task that 
initiated the dialogue. 


contains the origin identifier of a 
terminal or task associated with a 
group. This field is used to 
determine the default print location 
and must match an origin identifier 
(OID) entered in a GROUP command 
before the default printing location 
will be used. (Left justified with 
trailing blanks.) 


contains the authority identifier 
(AID) terminal/task issuing the 
message. The AID is used by the 
spooler to determine whether or not 
an origin location has the authority 
to perform the command function 
requested. (Left justified with 
trailing blanks.) 


contains the setting that identifies 


the general type of message being 
sent. The possible settings are: 


From task to SPL/32: 


X'O' = Command message 
X'2‘ = Acceptance response message 
X'3' = Request for mnemonic table 


From SPL/32 to ctasks or sctasks: 


X'O2' = Acceptance response message 
X'10' = Service message 
> Soa Us a Exception response message 


X'12' Attention message 
X'14" = Mnemonic message 
X'15" = Authority message 
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MESSAGE SUBTYPE CODE 


COMMAND IDENTIFIER 


COMMAND FUNCTION 


USER ACCOUNT 


DEFAULT VOLUME 


ROUTING FLAG 
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contains the type of attention or 
exception message present. 


contains the numeric identifier of 
a preparsed command. (The setting 
for each command is presented in 
Appendix E.) When ASCII command 
format is being used, this’ field 
contains zeros. 


For an exception response message, 
this field is the numeric identifier 
of the command that generated the 
exception response. 


contains the setting that identifies 
what function of the command is to 
be performed. Codes identify a 
GQisplay or set function request and 
identify the various option settings 
for some commands. The command 
function settings are presented in 
Appendix E. 


contains the account number of a 


request if the account is not 
explicitly specified in a file 
descriptor. It also provides a 
control task with a means of 
restricting access to files. If the 
account number specified in a 
request does not match the user's 
account, group account, or system 
account, the request is invalid. In 


an MTM environment, account numbers 
are used to identify the P, G, and 
S account class specifiers. This 
field must be set to X'FFFF' if not 
used. 


contains the default volume name for 
each request. If the volume is) not 
specified in a request, the default 
volume is used. This field must be 
set to X'FFFFFFFF' if not used. 


specifies the route that responses 
from the spooler to a subcontrol 


task take. A value of X'FF' causes 
responses to be returned to the 
originating subcontrol task. A 


value of X'OO' causes the message to 
be returned to the control task 
monitor ing the originating 
subcontrol task. 


D.4 MESSAGE FORMATS 
The following sections detail the format of the various messages 
that SPL/32 uses to perform the spooling function. The function 


of each message is described in Sections 5.2 through 5.3. In 
Sections D.4 through D.4.11, the following convention is used: 


Fields within the SVC6 send data message buffer and the 
message header are not redefined unless they change for the 
message being presented. The contents of these fields are 
discussed in Section D.3. 


D.4.1 Task to SPL/32 Message Formats 


There are three message types that control tasks can issue to the 
spooler: 


e® Command messages 
@ Acceptance response messages 


e Request for mnemonic table messages 
These formats are presented in the following sections. 
D.4.1.1 The Command Message 


The message format for command messages is presented in Figure 
D-2. This format is used for both ASCII and preparsed commands. 
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4065 0 (00) 
MESSAGE BUFFER FOR SVC6 SEND DATA 
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20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72° (48) 
76 = (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AQ) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4) 
232 (E8 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure D-2 Command Message Format 


MESSAGE HEADER 


65 (41) 


RESERVED 


RESERVED 


SPL/32 
COMMAND 


DD 


“ gy 


Fields: 


COMMAND contains a preparsed or ASCII format 
spooler command. 


Discussion: 


'f a command message is issued from a control task, then SPL/32 
issues a response to the command. If the command is accepted, 
then the message subtype code contains zero. If there is an 
exception error, the message subtype code indicates the problem. 


Command messages from subcontrol tasks are returned to the 
subcontrol task (if the routing flag so indicates) in the same 
manner. 


If the command message is from a subcontrol task and the response 
is to be returned to a control task (as indicated by the routing 
flag), then only responses required to service the message are 
sent to the control task. Exception responses with error code 0 
are not sent to the control task. 


D.4.1.2 Acceptance Response Message Format 


The format of an acceptance response message is presented in 
Figure D-3. 
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4088 
O (00) MESSAGE BUFFER FOR SVC6 SEND DATA 


20 
24 
28 
32 
36 
40 
44 
48 
52 
56 


60 
64 
68 
72 


76 
80 
84 
88 
92 
96 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4c 

(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (BC) 
144 (90) 
148 (94) 
162 (98) 
156 (9 

160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4 


232 


236 (EC 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure D-3 
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MESSAGE HEADER 


RESERVED 


RESERVED 


NEW AUTHORIZATION IDENTIFIER 


PSEUDO DEVICE NAME 
ACCEPTANCE FLAG 


RESERVED 


Acceptance Response Message Record 


Format. 


Fields: 


MESSAGE HEADER 


NEW AUTHORIZATION 
IDENTIFIER 


PSEUDO DEVICE NAME 


ACCEPTANCE FLAG 


information in the fields of this 
portion of the message is identical 
to the information contained in the 
corresponding fields of the 
authority message being responded to 
with the exception of the MESSAGE 
TYPE ID field which is set to X'2'. 


contains the new authorization 
identifier carried in the 
corresponding field of the authority 
message being responded to. 


contains the name of a pseudo 
device. This field is used only 
when the AID specified in the NEW 
authorization identifier field 
pertains to a secondary 
authorization location. The pseudo 
device specified is the pseudo 
device to which the NEW 


authorization identifier pertains. 
contains one of the following 


settings: 


xX'OOOO0' 
X'FFFF' 


AID accepted 
AID rejected 


D.4.1.3 Request for Mnemonic Table Message 


The format of a request for mnemonic table message is presented 


in Figure D-4. 
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4034 0 (00) 
| MESSAGE BUFFER FOR SVC8 SEND DATA | 


20 (14) 
24 (18) 
28 (1C) MESSAGE HEADER 
32 (20) 

36 (24) 

40 (28) 

44 (2C) 

48 (30) 

56 (38) 

60 (3C) 

64 (40) 65 (41) 
68 

72 


(44) 

(48) 
76 = (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) RESERVED 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9 
160 (AQ) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) RESERVED 
216 (D8) 
220 (DC) 
224 (EQ) 
228 (E4) 
232 (E8 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


RESERVED 


Figure D-4 Request for Mnemonic Table Record Format 
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Fields: 


MESSAGE HEADER the message subtype code must be set 
to X'3°. 


Discussion: 


Once a request for a mnemonic table message has been received, 
the spooler sends the mnemonic table to the requesting control 
task using the mnemonic message format presented in Section 
D.4.6. 


D.4.2 SPL/32 to Task Message Formats 


There are five types of messages that SPL/32 can issue to a 
control task: 


@® Service response messages 

e Exception response messages 
e Authority messages 

e Attention messages 

e Mnemonic messages 


e Acceptance response messages 


D.4.2.1 Service Response Message Format 


The service response message is used to supply information, from 
the spooler to a requestor, that pertains to the current spooler 
environment. The amount of information supplied depends on the 
size and configuration of the spooling environment, and is 
therefore variable. To accommodate this variability, service 
response messages consist of a chain of buffers. Each chain 
consists of at least one 256-byte buffer. Therefore, the 
requestor must have at least 256 bytes of buffer space to receive 
service response messages from the spooler. Each message is sent 
with one SVC6 SEND DATA function. If the receiving task does not 
have enough buffer space to accommodate an entire message, the 
message is broken into a series of single buffer messages. Each 
single buffer uses an SVC6 SEND DATA function. The last single 
buffer sent in the series is indicated by an X'FFFF' in the last 
buffer field of the service response message buffer structure. 
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D.4.2.2 Buffer Set Format 


A service response message uses two different buffer formats, an 
initial buffer and a continuation buffer. When a message is sent 
and the user has enough buffer space to accommodate the entire 
message, both buffer formats are used. If the user does not have 
enough buffer space to accommodate the entire message, the 
message is broken down into a series of single buffer messages. 
Each of these messages uses the initial buffer format. The 
format of an initial buffer is presented in Figure D-5. 
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Figure D-5 


AQ. | 


20 (14) 
24 = (18) 


100 (64) 
104 (88) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AQ) 
164 (A4) 
168 (A8) 
172 {AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (E8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Service Response Message - 


MESSAGE BUFFEL KH POR SVCB6 SEND DATA | 


MESSAGE HEADER 


RESERVED 


RECORD 1 


RECORD 2 


Initial Buffer Format 
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Fields: 


MESSAGE HEADER the type of service records 
contained in a buffer are identified 
by the command identifier and 
command function bytes of the 
message header. 


NUMBER OF RECORDS contains an X'L' or X'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates whether the buffer is the 
last in a chain of buffers. If the 


buffer is not the last buffer, this 
field contains zeros. 


RECORD 1 contains the spooler response to a 
command request. The response is in 
ASCII and variable in length 
depending on the spooler 
environment. 


When the full 80 bytes are not used, 
the remainder of the field is blank 
filled. 


RECORD 2 contains the spooler response to a 
command request. The response is in 
ASCII format and is variable in 
length depending on the spooler 
environment. 


When the full 80 bytes are not used, 
the remainder of the field is blank 
filled. 


The continuation buffer in a buffer set is structured as 
presented in Figure D-6. The message buffer for the SVC6 send 
data function in the first buffer of the set applies to all 
buffers of the set and is not repeated in subsequent buffers. 
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4036 


SVC6 CONTINUATION 


NUMBER OF RECORDS 


HEADER 


{OU LAST BUFF 


RESERVED 


RECORD 3 


RECORD 4 


RECORD 5 


48-056 FOO ROO 


Fields: 


NUMBER OF RECORDS contains an X'1', X'2', or xX'3' to 


indicate the number of records used 
in the buffer. 


RECORD 3 contains the spooler response to a 
command request. The response is in 
ASCII and variable in length 
depending on the spooling 
environment. When the full 80 bytes 
are not used, the remainder of the 
field is blank filled. 


RECORD 4 contains the spooler response to a 
command request. The response is in 
SCII and is variable in length 
depending on the spooling 
environment. When the full 80 bytes 
are not used, the remainder of the 
field is blank filled. 


RECORD 5 contains the spooler response to a 
command request. The response is in 
SCII and is variable in length 
depending on the spooling 
environment. When the full 80 bytes 
are not used, the remainder of the 
field is blank filled. 


The spooler determines the number of buffers and buffer sets 
required by a service response message. If a message consists of 
one to two 80-byte records, only the initial buffer is required, 
the records are placed in the RECORD 1 and RECORD 2 fields of the 


initial buffer. If the message consists of more than two 80-byte 
records, the continuation buffer may be used depending on_ the 
amount of receive buffer space the user has allocated. If the 


receive buffer space allocated cannot accommodate the _ entire 
service message, SPL/32 will use multiple initial buffers to send 
the message. The continuation buffer is not used. If the user 
does have enough receive buffer space allocated to accommodate 
the entire message, then the continuation buffer will be used to 
transport records 3 through 5, 6 through 8, etc. Service 
response messages that are variable in length are noted as such 
in the description of the message in the following sections’ so 
that the reader is aware that multiple buffer sets are used to 
transport these messages. 
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D.4.3 Individual Command Service Response Messages 


The following sections present the individual record format for 
each spooler command service response message. The messages are 
presented in one 256-byte buffer format. The reader should note 
that messages consisting of more than two 80-byte records will be 
formatted according to the procedure described in the previous 
section based on the available receive buffer space allocated. 


D.4.3.1 ATTACH Command Service Record 
The format of the ATTACH command service record is presented in 


Figure D-7. This message is issued by the spooler when a pseudo 
device specified in an ATTACH command was not previously created. 
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4037 
0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 (14) 

24 = (18) 

28 (1C) MESSAGE HEADER 
32 (20) 

36 (24) 

40 (28) 

44 (2C) 

48 (30) 

52 (34) NS ba She 54(36) . COMMAND | 65(37 
66 (38) 

60 (3C) 

64 (40) 

Sai a OF 
72 (48) 

76 (4C) 

80 (50) 

84 (54) RESERVED 
88 (58) 

92 (5C) 

96 (60) 

100 (64) 

104 (68) 

108 (6C) 

112 (70) 

116 (74) 

120 (78) 

124 (7C) 

128 (80) BLANK 
132 (84) FILLED 
136 (88) 

140 (8C) 

144 (90) 

148 (94) 

152 (98) 

156 (9C) 

160 (AO) 

164 (A4) 

168 (A8) 

172 (AC) 

176 (BO) 

180 (B4) 

184 (88) 

188 (BC) 

192 (COQ) “PSEUDO DEVICE CREATED 
196 (C4) IMPLICITLY” 
200 (C8) 

204 (CC) 


708-10) 


212 (D4) DEVICE NAME 
216 (D8) 


220 (DC) 
224 (EO) 
228 (E4) 
232 {E8 
238 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure D-7 ATTACH Command Service Message Record Format 
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Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


PSEUDO... IMPLICITLY 


PSEUDO DEVICE NAME 


contains an X'1l' to identify the 
ATTACH command. 


contains an xX'3' to identify the 
SPECIFY function of the ATTACH 
command. 


contains an X'l1l' or X‘'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text message that precedes’ the 
new pseudo device name. 


contains the name of the implicitly 
created pseudo device. 


D.4.3.2 BLOCK Command Service Record 


The format of the BLOCK command service record is presented in 
Figure D-8. This message is issued in response to a request to 
display the data and index blocksize values. 
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4038 0 (00) 
MESSAGE BUFFER FOR SVC6 SEND DATA 


20 (14) ‘ 
24 (18) 

28 (1C) MESSAGE HEADER 
32 (20) 

36 (24) 

40 (28) 

44 (2C) 

48 (30) 

66 (38) 

60 _(3C) 

64 (40) 

68 (44) NUMBER OF RECORDS 
72 (48) eS 

76 (4C) 

80 (60) 

84 (54) RESERVED 
@8 (68) 

92 (5C) 

96 (60) 

100 (64) 

104 (68) 

108 (6C) 

112 (70) 174 


116 (74) BLOCKS 118(76) 


“DATA BLOCK SIZE =” 


NUMBER OF 


120 (78) BLANKS 
124 (7C) 


128 (80) 
132 (84) 
136 (88) 
140 (8C) 142 GET cen oF 
144 (90) BLOCKS 146(92) 

148 (94) 3: 

152 (98) 

156 (9C) 

160 (AQ) BLANKS 

164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (£4) 
232 (E8 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
262 (FC) 


“INDEX BLOCK SIZE =“ 


BLANKS 


Figure D-8 BLOCK Command Service Message Record Format 
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Fields: 


COMMAND ID contains an X'3' to identify the 
BLOCK command. 

COMMAND FUNCTION contains an xX'O' to identify the 
DISPLAY function of the BLOCK 
command. 

NUMBER OF RECORDS contains an X'1' or X'‘'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


DATA BLOCK SIZE = is a text header that precedes’ the 
Gata blocking factor. 

NUMBER OF BILOCKS is the current data blocking factor. 

INDEX BLOCK SIZE = is a text header that precedes’ the 
index blocking factor. 

NUMBER OF BLOCKS is the current index blocking 
factor. 


D.4.3.3 CHECKPOINT Command Service Record 


The format of the CHECKPOINT command service record is presented 
in Figure D-9. This message is issued in response to displaying 
the current checkpoint value. 
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4039 0 (00) a. 
| MESSAGE BUFFER FOR SVC6 SEND DATA 


Figure D-9 
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20 
24 
28 
32 
36 
40 
44 
48 
52 
56 
60 
64 
68 
72 
76 
80 
84 
88 
92 
96 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (B80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C} 
160 (AQ) 
164 (A4) 
168 {A8) 


172 (AC) 


176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (D0) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4 


332 
236 (EC) 
240 (FO) 


244 (F4) 
248 (F8) 
252 (FC) 


MESSAGE HEADER 


~ 54(36) COMMAND | 58(37) COMMAND 
ID FUNCTION 


NUMBER OF RECORDS LAST BUFF 


RESERVED 


“CHECKPOINT VALUE 


NUMBER 


BLANKS 


BLANKS 


CHECKPOINT Command Service Message Record Format 


Fields: 


COMMAND ID contains an X'5' to identify the 
CHECKPOINT command. 

COMMAND FUNCTION contains an xX'O' to identify the 
DISPLAY function of the CHECKPOINT 
command. 

NUMBER OF RECORDS contains an X'l1' or X'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


CHECKPOINT VALUE = is a text message that precedes’ the 
checkpoint value. 


NUMBER is the current CHECKPOINT value. 


D.4.3.4 CTASK Command Service Record 


The format of the CTASK command service record is presented in 
Figure D-10. The CTASK command service record has a variable 
number of entries depending on the number of control tasks 
present in the spooling environment. 
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4040 0 (00) 
MESSAGE BUFFER FOR SVC6 SEND DATA 


20 
24 
28 
32 
36 


40 
44 
48 
52 


56 
60 


64 
68 
72 
76 
80 
84 
88 


92 
96 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (B4) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98 

156 (9C) 
160 (AO) 
164 (A4) 


168 


A8 


172 (AC) 
176 (BO) 
180 (B4) 
184 (BB) 


188 (BC) 


192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4) 
232 {E 


236 (EC) 


240 (FO) 
244 (F4) 
248 (FS) 
262 (FC) 


MESSAGE HEADER 


54(36) COMMAND J65(37}COMMAND 
Io FUNCTION 


NUMBER OF RECORDS [7x26 soe EOS BUER oe 


RESERVED 


“CTASKS = “ 


TASKNAME 1 


113(71) 
TASKNAME 2 


122(7A) 9 
TASKNAME 3 


| 131(88) ry 


TASKNAME 4 


TASKNAME 5 


149(95) @ ; nea 


TASKNAME 6 


TASKNAME 7 


TASKNAME 8 


ETC, 


Figure D-10 CTASK Command Service Message Record 
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Format 


Fields: 


COMMAND ID contains an xX'7' to identify the 
CTASK command. 

COMMAND FUNCTION contains an X'‘'O' to identify the 
DISPLAY function of the CTASK 
command. 

NUMBER OF RECORDS contains an X'1l‘' or X'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


CTASKS= is a text header that precedes’ the 
list of control tasks. 


TASKNAME 1 is the name of a control task in the 
spooler environment. 


, separates the displayed control task 
names. 

D.4.3.5 FORM Command Service Record 

The format of the FORM command service record is presented in 


Figure D-ll. This message has a variable number of entries 
depending on the number of forms in the spooling environment. 
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4041 
0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 
24 
28 
32 
368 
40 
44 
48 
52 
56 


60 
64 
68 
72 


76 
80 
84 
88 
92 
96 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (80) 
148 (94) 
152 (98) 
166 (9C) 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 


184 (B8) 


188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (04) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4) 
232 (E8 

236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure D-1l FORM Comman 
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MESSAGE HEADER 


70(46) 


NUMBER OF RECORDS LAST BUFF 


RESERVED 


“FORMS = “ 


FORMNAME 1 
FORMNAME 2 


FORMNAME 3 


ETC. 


Service Message Record 


Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


contains an xX'B' to identify the 
FORM command. 


contains an xX'O' to identify the 
DISPLAY function of the FORM 
command. 


contains an X'1' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text header that precedes’ the 
form names to be displayed. 


is a valid form name. 


separates each displayed form name. 


D.4.3.6 GLOBAL Command Service Record 


The format of the GLOBAL command service record is presented in 


Figure D-12. 
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4042 0 (00) 
| MESSAGE BUFFER FOR SVC6 SEND DATA | 


Figure D-12 GLOBAL Command Service Message Record Format 
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(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(60) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AQ) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (D0) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (E8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


MESSAGE HEADER 


54(36) COMMAND | 55(37) COMMAND 
ite) FUNCTION 


NUMBER OF RECORDS [rov4e LAST BUFF 


RESERVED 


“GLOBAL PSUEDO DEVICE = “ 


DEVICE NAME 


BLANKS 


BLANKS 


Ds} 


Fields: 


COMMAND ID contains an xX'C' to identify the 
GLOBAL command. 

COMMAND FUNCTION contains an xX'O' to identify the 
DISPLAY function of the GLOBAL 
command. 

NUMBER OF RECORDS contains an X‘'1' or X'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


GLOBAL PSEUDO DEVICE is a text message. 


NAME is the current global pseudo device. 


D.4.3.7 Q@ROUP Command Service Record 


The GROUP command service record is variable in length and 
consists of two records. The first record contains the names of 
the default pseudo device and the monitor control task for a 
group. The second record contains the names of the group members 
with a maximum of seven members per record. The formats of the 
two records are presented in Figure D-13. 
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4043 0 (00) 
| ( MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 


84 (54) © 


88 (58) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
740 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9G) 
T60 (AO) 
164 (A4) 
168 (AB) 
172 (Ac) 
176 (BO) 
180 (B4) 
184 (BS) 
188 (BC) 
792 (CO) 
196 (C4) 
200 (CB) 
204 (CC) 
208 (D0) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4) 
732 (66) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (FB) 
252 (FC) 


Figure D-13 GROUP 


MESSAGE HEADER 


NUMBER OF RECORDS LAST BUFF 


I 70(46) 


RESERVED 


PSEUDO DEVICE = 


PSEUDO DEVICE NAME 


BLANK 


CONTROL TASK = 
HEADER RECORD 


TASK NAME 


BLANK FILLED 


UNIT 1D 14 


UNIT ID 2 


UNIT ID 3 


se aT Se ee | 9 


UNIT ID 4 


UNIT ID 5 DATA RECORD 


UNIT ID 6 
| t 
UNIT ID 7 
5 


UNIT ID 8 
: | . b 


UNIT ID 9 


Command Service Message - Header Record 


Data Record Formats 
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Fields: 


CHAIN INDICATOR 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


PSEUDO DEVICE= 


DEVICE NAME 


CONTROL TASK= 


TASKNAME 


UNIT ID 


indicates the position the buffer 
set occupies in a chain: first, 
last, or middle. 


contains an X'D' to identify the 
GROUP command. 


contains an xX'O' to identify the 
DISPLAY function of the GROUP 
command. 


contains an X'l' or X‘'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text header. 


is the name of the default pseudo 
device for the group. 


is a text header. 


is the name of the monitor control 
task. 


is the name of a terminal/task in 
the group. 


D.4.3.8 INPUT Command Service Record 


The structure of the INPUT command service record is presented in 
Figure D-14. This record can have a variable number of entries 


depending on the 


environment. 


of input devices in the spooling 


48-056 FOO ROO 


4044 
0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 (14) : 
24 (18) 

28 (1C) MESSAGE HEADER 

32 (20) 

36 (24) 

40 (28) 

44 (2C) 

48 (30) 

om) ==. 
56 (38) 

60 (3C) 

64 (40) 

6B (44) NUMBER OF RECORDS 70146) = LAST BUFF 
72 (48) 

76 (4C) 

80 (60) 

84 (64) RESERVED 

88 (58) 

92 (5C) 

96 (60) 

100 (64) 

104 (68) 

108 (6C) 


112 (70) DEVICE 1 ae ee 


116 (74) ry DEVICE 
120 (78) 9 ° 3 


124 (7C) DEVICE 3 | og 


128 (80) 3 DEVICE 

136 (88) DEVICE 5 he eee 
140 (8C) 3 a. DEVICE 

144 (90) F 3 ; 


148 (64) DEVICE 7 ae ee 


152 (98) 8 DEVICE 


4 


INPUT DEVICES = 


160 (AQ) DEVICE 9 
164 (A4) P DEVICE 


168 (A8) 10 8 | % 


172 (AC) DEVICE 11 
176 (BO) 


180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (£4) 
232 (E8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


ETC. 


Figure D-14 INPUT Command Service Message Record Format 
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Fields: 


CHAIN INDICATOR indicates the position the buffer 
set occupies in a chain: first, 
last, or middle. 


COMMAND ID contains an X'E' to identify the 
INPUT command 

COMMAND FUNCTION contains an xX'O' to identify the 
DISPLAY function of the INPUT 
command. 

NUMBER OF RECORDS contains an X'1l‘ or X'2' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


INPUT DEVICES= is a text header. 

DEVICE L is the name of an input device. 

ae separates each displayed input 
device. 


D.4.3.9 INTERROGATE Command Service Record 


The format of an INTERROGATE command service record depends’ upon 
the type of INTERROGATE command entered. The format of an 
INTERROGATE QUEUE, FD, PD, or FORM request is presented in Figure 
D-15 and D-16. The first record contains the column headers’ and 
the second record contains the spool queue entries. This message 
is variable in length depending upon the number of entries on the 
spool queue. 
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4046 0 (00) 
MESSAGE BUFFER FOR SVC6 SEND DATA | 


Figure D-15 
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20 (14) : 

24 = (18) 

28 (1C) MESS.AGE HEADER 
32 (20) 

36 (24) 


60 (3C) 

64 (40) 

68 

72 (48) 

76 (4C) 

80 (50) 

84 (54) RESERVED 
88 (58) 

92 (5C) 

96 (60) 

100 (64) 

104 (68) 

108 (6C) 109(60) 
112 (70) : 
116 (74) 118(76) 
120 (78) —— 
124 (7C) 
128 (80) ceili COPY 
132 (84) 

136 (88) PRIORITY 


PSEUDO DEVICE 


FILE NAME 


FORMNAME 


140 (6C) ~ OPTIONS 


(44) NUMBER OF RECORDS zo) LAST BUFF 


135(87) 


RECORD 1 
HEADER RECORD 


144 (90) | 146(92) 


148 (94) 

152 (98) 

156 (9C) { 

160 (AQ) BLANKS 
164 (A4) 

168 (A8) 

172 (AC) 


176 (BO) PSEUDC DEVICE NAME 


180 (B4) t 181(B5) BLANKS 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 206(CE) 
208 (DO) es 

212 (D4) 

216 (D8) 

220 (DC) FORMNAME 
224 (E0) 

228 (E4) 


252 (EB BLANKS _ 


240 (FQ) 242(F2) P 


FILE DESCRIPTOR 


244 (F4) BLANKS 


“T 183187) 


BLANKS 


RECORD 2 
DISPLAY RECORD 


231(E7) 


235(EB) COPIES 
NUMBER 


RIORITY | 243(F 3) 


249(T9) 250(F A) . 251(F R) 
OLD OR RELEASE | ge IMAGE OR FORMA ipeeee. enernies 
i DELETE OR 25a(F 1D) oat F) 268(t 1) 
Saati LIE —_ VEG URNOVIC KL ANK 


INTERROGATE Command Service Message Header and 


Display Record Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


PSEUDO DEVICE 
F [LENAME 

FORM NAME 
COPY 

PRIORITY 
OPTIONS 


PSEUDO DEVICE NAME 


contains an X'F‘' to identify the 
INTERROGATE command. 


contains one of the following to 


identify the parameter being 
interrogated: 
e X‘'10' = QUEUE 


e xX'‘'1ll' = PD 


e xX'‘'12' 


FORM 


e@ <X'13' 


FD 


contains an X'1' or X'2' to indicate 
the number of records used in the 
buffer. 

contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 

is a text header. 

is a text header. 

is a text header. 

is a text header. 

is a text header. 


is a text header. 


is the name of the pseudo device the 
file is assigned to. 
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FILE DESCRIPTOR is the file descriptor of the’ spool 


file. 

FORM NAME is the name of the form that’ the 
file requires for output. 

NUMBER OF COPIES is the number of copies of the file 
to be output. 

PRIORITY is the output priority of the file. 

HOLD, IMAGE, DELETE, VFC are optional output parameters of 
the file. 


The format of an INTERROGATE CONFIGURATION command consists of 
two record types: a header record and a spooler device entry 
record. The response to this command can be variable in length 
depending upon the number of devices in the spooler environment. 
The format of the header record and the device entry record is 
presented in Figure D-16. 
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4046 


Figure D-16 


| 0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA 


MESSAGE HEADER 


54(36) COMMAND | 56(37) COMMAND 
ID FUNCTION 


60 (3C) 


64 (40) 
68 (44) NUMBER OF RECORDS 70(46) LAST BUFF 


REAL DEVICE 


107(68) 


108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 


DEVICE STATUS 


FORM MOUNTED 


FILE PRINTING 


146(91) 


ASSOCIATED PSEUDO DEVICES 


BLANKS 


176 (BO) 


___ REAL DEVICE NAME 
180 (B4) : BLANKS 
184 (B8) DEVICE STATUS 


BLANKS 
RESERVED 


192 (CO) 
196 (C4) 
200 (C8) 


NAME OF FORM MOUNTED 


RESERVED 


BLANKS 


212 (D4) 
216 (D8) 


NAME OF THE 
FILE PRINTING 


240 (FO) BLANKS or 
244 (F4) PSEUDO DEVICE 1 P= ieee | 
248 (F8) BLANK PSEUDO DEVICE 2 

252 (FC) PAK 


RECORD 1 
HEADER RECORD 


RECORD 2 
DATA RECORD 


INTERROGATE Configuration Command Service Message 
Record Format 
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Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


REAL DEVICE 

DEVICE STATUS 

FORM MOUNTED 

FILE PRINTING 

ASSOCIATED PSEUDO DEVICES 


REAL DEVICE NAME 


DEVICE STATUS 


NAME OF FORM MOUNTED 


NAME OF FILE PRINTING 


PSEUDO DEVICE1,...,N 
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contains an X'F' to identify the 
INTERROGATE command. 


contains one of the following to 


identify the parameter being 
interrogated: 

e X'10' = QUEUE 

@ xX'1l' = PD 

e xX‘'12' = FORM 

e <X‘'13' = FD 


contains an X'1' or X‘'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 

is a text header. 

is a text header. 

is a text header. 

is a text header. 


is a text header. 


is the name of a real device in the 
spooler environment. 


is the status of the preceding real 
device. 


is the name of the form mounted on 
the preceding real device. 


is the name of the file printing on 
the preceding real device. 


are the names on pseudo devices 
associated with the preceding real 
devices. 


0.4.3.10 PRIMARY Command Service Record 


The format of the PRIMARY command service record is presented _ in 
Figure D-17. 
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20 
24 
28 
32 
36 
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(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98 

156 (9C} 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 


792 (CO) 


196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 

32 (E8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure D-17 
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MESSAGE HEADER 


54(36) COMMAND] 55(37) COMMAND 
iD FUNCTION 


70(46) 


NUMBER OF RECORDS LAST BUFF 


RESERVED 


“PRIMARY CTASK = “ 


CONTROL TASK NAME 
BLANKS 


| 126(7E) 


“AID =" 


AUTHORIZATION IDENTIFIER (AID) 


BLANKS 


BLANKS 


PRIMARY Command Service Message Record 


Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


PRIMARY CTASK= 
TASKNAME 
,AID= 


PRIMARY AID 


contains an X'10' to identify the 
PRIMARY command. 


contains an xX'O' to identify the 
DISPLAY function of the PRIMARY 
command. 


contains an X'l1'‘' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 

is a text message. 

is the primary control task. 


is a text message. 


is the primary authorization 
identifier. 


D.4.3.11 PRIORITY Command Service Record 


The format of the PRIORITY command service record is presented in 


Figure D-18. 
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Figure D-18 
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20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
66 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 = (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (SC) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 {7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EQ) 
228 (E4) 
KY 

236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


e 


MESSAGE HEADER 


NUMBER OF RECORDS 70(46) LAST BUFF 


RESERVED 


“PRIORITY = “ 


107(68) 


PRIORITY VALUE 


BLANK 


BLANK 


PRIORITY Command Service Message Record Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


PRIORITY 


DEFAULT OUTPUT PRIORITY 


contains an X'12' to identify the 
PRIORITY command. 


contains an xX'O' to identify the 
DISPLAY function of the PRIORITY 
command. 


contains an X‘'1' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text message. 


is the default output priority 
value. 


D.4.3.12 QUEUE Command Service Record 


The format of the QUEUE command service record is presented in 


Figure D-19. 
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20 
24 
28 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


700 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
728 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
748 (94) 
752 (98) 
756 (0) 
160 (AO) 
164 (A4) 
768 (AB) 
172 (AC) 
176 (BO) 
760 (64) 
184 (B8) 


188 (BC) 


192 (CO} 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 


228 (4) 


a 


236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
262 (FC) 


MESSAGE HEADER 


54(36) COMMAND] 55(37) COMMAND 
ike) FUNCTION 


NUMBER OF RECORDS 70146) __ LAST BUFF 


RESERVED 


QUEUE FILE = 


109(6D) 


FILE DESCRI°TOR OF QUEUE FILE 


BLANKS 


BLANKS 


Figure D-19 QUEUE Command Service Message Record 
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Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


QUEUE FILE= 


FILE DESCRIPTOR 


contains an X'14' to identify the 
QUEUE command. 


contains an xX'O' to identify the 
DISPLAY function of the QUEUE 
command. 


contains an X'1' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text message. 


contains the full file descriptor 
for the current spool queue file. 


D.4.3.13 SCTASK Command Service Record 


The SCTASK command 


record has a variable number of 


entries. The format of this message is presented in Figure D-20. 
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20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
T52 (98) 
756 (9C 
160 (A0) 
164 (A4) 
768 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (D0) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (E0) 
228 (E4) 
232 (ES 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


MESSAGE HEADER 


64(36) COMMAND f 58(37) COMMAND 
1D FUNCTION 


NUMBER OF RECORDS mee LAST BUFF 


RESERVED 


“CTASK =" 


MONITOR CONTROL TASK NAME 


BLANKS 


SCTASKS = 


SUBCONTROL TASK 1 


SUBCONTROL TASK 2 


fe 


SUBCONTROL TASK 3 
9 


sUBCONTROL TASK 4 eee! 


SUBCONTROL TASK 5 


BLANK 


ETC. 


Figure D-20 SCTASK Command Service Message Record 
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Format 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


CTASK= 


MONITOR CONTROL TASK NAME 


SCTASKS= 


SUBCONTROL TASK N 


contains an X'18' to identify the 
SCTASK command. 


contains an xX'O' to identify the 
display function of the SCTASK 
command. 


contains an X'l1' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last in a chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text header. 

contains the name of the control 
task monitoring the subcontrol 
tasks. 


is a text header. 


is the name of a subcontrol task. 


D.4.3.14 SECONDARY Command Service Record 


The SECONDARY command service record has a variable number of 
entries depending upon the spooling environment. The format of 
the SECONDARY command service record is presented in Figure D-20. 
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Figure D-21 
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20 
24 
28 
32 
36 
40 


[ 44 


48 
52 
56 


60 
64 
68 
72 


76 
80 
84 
88 
92 
96 


(14) 
(18) 
(ic) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(64) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
162 (98) 
166 (9C) 
160 (A0} 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 


228 (E4) 


2 (E8 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


MESSAGE HEADER 


54(36) COMMAND! 55(37) 
ID FUNCTION 


NUMBER OF RECORDS | ices LAST BUFF 


RESERVED 


DEVICE/AID = 


PSEUDO DEVICE 
NAME 1 | Cn / 


SECONDARY AUTHORIZATION IDENTIFIER 4 
$ 


PSEUDO DEVICE NAME 2 
4 
SECONDARY AUTHORIZATION IDENTIFIER 2 
i. PSEUDO 
DEVICENAME3 : 


=o Scere nee ee pees eee) 


SECONDARY AUTHORIZATION IDENTIFIER 3 


| $ PSEUDO DEVICE 


NAME 4 : / 


SECONDARY AUTHORIZATION IDENTIFIER 4 


BLANKS 


ETC. 


SECONDARY Command Service Message Record Format 


51 


Fields: 


COMMAND ID contains an X'l17' to identify the 
SECONDARY command. 

COMMAND FUNCTION contains an xX'O' to identify the 
DISPLAY function of the SECONDARY 
command. 

NUMBER OF RECORDS contains an X'l' or X'2‘' to indicate 
the number of records used in the 
buffer. 

LAST BUFF contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 


buffer is not the last buffer ina 
chain, the field contains zeros. 


DEVICE/AID= is a text message. 

PSEUDO DEVICE 1 is the name of a pseudo device. 

SECONDARY AID FOR PSEUDO is the secondary authorization 

DEVICE 1 identifier for the preceding pseudo 
device. 


D.4.3.15 The SPVOLUME Command Service Record 


The SPVOLUME command service record has a variable number of 
entries depending upon the number of spooled volumes on the 
system. The format of the SPVOLUME command service record is 
presented in Figure D-21. 
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4064 


| 0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 
24 
28 
32 
36 
40 
44 
48 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (E8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


MES. 


NUMBER OF RECORDS 


. 


SAGE HEADER 


ies LAST BUFF 


SPOOL VOLUMES = 


VOLUME 


SPOOL VOLUME 


3 9 
VOLUME 4 
VOLUME 


SPOOL VOLUME 


9 
7 9 
VOLUME 8 
VOLUME 


SPOC 


9 
1 Ln 


VOLUME 12 


oo 


VOLUME 


SPOOL VOLUME 
SPOOL 


SPOOL VOLUME 


SPOOL 
g eee ee 
iL VOLUME 10 
SPOOL VOLUME 


—— SPOOL 
ae aie a 


ETC. 


Figure D-22 SPVOLUME Command Service Message Record Format 
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D 


53 


Fields: 


COMMAND ID 


COMMAND FUNCTION 


NUMBER OF RECORDS 


LAST BUFF 


SPVOLUMES = 


VOLUME N 


contains an X'19' to identify the 
SPVOLUME command. 


contains an X'O' to identify the 
DISLAY function of the SPVOLUME 
command. 


contains an X'1' or X'2' to indicate 
the number of records used in the 
buffer. 


contains a setting (X'FFFF') that 
indicates that the buffer is the 
last ina chain of buffers. If the 
buffer is not the last buffer ina 
chain, the field contains zeros. 


is a text header. 


contains the volume name of a 
spooled disk volume. 


D.4.4 Exception Response Messages 


The format of an 
Figure D-23. 


D-54 


exception 


response message is presented in 
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4053 0 {00 
| ) MESSAGE BUFFER FOR SVC6 SEND DATA | 


20 (14) 
24 (18) 
28 (1C) MESSAGE HEADER 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
=o 2 al 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AO) 
164 (A4) 
168 (AS) 
172 (AC) 
176 (BO) 
180 (B4) 
| 184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (CB) 
204 (CC) 
208 (D0) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4 
232 (E86) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (FB) 
252 (FC) 


RESERVED 


MESSAGE TEXT 


MESSAGE RELATED 
DATA 


Figure D-23 EXCEPTION Response Message Format 
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Fields: 


MESSAGE SUBTYPE CODE contains one of the error code 
numbers presented in Table D-l. 
This code indicates the type of 
exception that occurred. 


MESSAGE TEXT contains the message text 
description that corresponds’ with 
the preceding error code identified 
in the message subtype field. The 
message text field entries are 
presented in Table D-1. 


MESSAGE RELATED DATA contains the item that caused the 
error with the exception of error 
code 5. The message related data 
field entries are presented in Table 
D-1l. When the error code is 5, this 
field contains the authorization 
level required to issue a command. 


TABLE D-l EXCEPTION MESSAGE ERROR CODES, MESSAGE TEXT, AND 
MESSAGE RELATED DATA SUMMARY 


Sa ee ee ee ee ee ee 


ERROR i 
{| CODE ; 
| (DECIMAL) | MESSAGE TEXT {| MESSAGE RELATED DATA | 
1 0 i No message (no error j H 
| occurred) 
‘ { ‘] ‘ 
i} I ! J 
H 1 | INVALID COMMAND: {; command that caused H 
' error 
| | | 
1 2 | INVALID KEYWORD: | Keyword that caused H 
! error 
| | 
} 3 | INVALID PARAMETER: } parameter that caused } 
i {} error { 
i 
4 | INVALID SEPARATOR: | separator that caused |} 
| error 
H 5 {| INVALID AUTHORIZATION {| level required 4 
{ i LEVEL: 1 H 
b { { t 
' t Uy ' 
1 6 i MISSING PARAMETER: 1 = H 
4 1 ‘ ' 
! { i t 
H 7 i INVALID DEVICE: {| device name given H 
H { { J 
4 t 1 t 
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TABLE D-1 EXCEPTION MESSAGE ERROR CODES, MESSAGE TEXT, AND 
MESSAGE RELATED DATA SUMMARY (Continued) 


(DECIMAL) | 
8 $ 


ee 
oo 
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MESSAGE TEXT 
INVALID TASK: 
DUPLICATE TASK NAME 
DUPLICATE DEVICE 
TASK NOT INCLUDED: 
DEVICE NOT INCLUDED: 
VOLUME NOT INCLUDED: 
CANNOT COMMUNICATE 
WITH CTASK 
INVALID VOLUME 
DUPLICATE VOLUME : 


INVALID INDEX BLOCK 
SIZE: 


INVALID DATA BLOCK 
SIZE: 


INVALID PRIORITY 
PRIMARY AUTHORITY 
REJECTED 

UNIT NOT INCLUDED 
DUPLICATE UNIT NAME 


INVALID AUTHORIZATION 
ID: 


FILE NOT FOUND: 
PARAMETER CONFLICT: 
INVALID FORM: 


DEVICE ACTIVE: 


| MESSAGE RELATED DATA 


a am ema eee ee ewe amen eee eee ewe eee eee eee ee awe wee eee ee ee ee eee en ee ee eee eee eee eee ee ee eee eee ees eee ee ee ee ee we re we we ee wwe we we 


task name given 
task name given 
device name given 
task name given 
device name given 
volume name given 


control task name 


volume name given 
volume name given 


index block size 
given 


Gata block size 
given 


priority given 


unit-id given 
unit-id given 


authorization id 
given 


file descriptor given 


parameterl, parameter2 


form name given 


device name given 


TABLE D-1 EXCEPTION MESSAGE ERROR CODES, MESSAGE TEXT, AND 
MESSAGE RELATED DATA SUMMARY (Continued) 


| ERROR i i | 
| CODE i i i 
| (DECIMAL) | MESSAGE TEXT | MESSAGE RELATED DATA |} 
| 2 SS SE a a De os oe ws | 
| 28 i DEVICE INACTIVE: | device name given H 
t t J \ 
t { { ! 
29 | FORM NOT INCLUDED | form name given 
{ 1) { t 
( 1 ] i 
i 30 i FILE PRINTING H 
4 ‘] ! t 
! t { i 
H 31 | REQUEST IS PENDING i name of form H 
i { FOR FORM: | 
H H 
H 32 { SVCl ERROR H type H 
i H 1 H 
H 33 i SVC7 ERROR i type { 
t ] | 4 
i I $ 1 
H 34 i SVC6 ERROR H type H 
( ] ( ' 
‘ | t ' 
H 35 | IMPLICITLY CREATED i name of pseudo device |} 
i} PSEUDO DEVICE H 
I i] { { 
‘ t i 1 
} 36 i MISSING CONTROL CARD |} = I 
{ i 
H 37 | INVALID CONTROL CARD |} = 
j { J ] 
( | 1 i) 
' 38 i IO TASK WAS CANCELLED | = { 
i H i H 
H 39 {| PRIMARY CTASK WAS H = i 
i CANCELLED t 
J i] { i 
t | | t 
40 | NO AVAILABLE LUs 1 = i 
4 { { { 
{ (] i i 
H 41 i NO SPOOL VOLUMES i = H 
t t t I 
() i} ] 1 
H 42 i NO SUBCONTROL TASKS H = H 
1 1 t { 
t i] ! 1 
H 43 | NO INPUT DEVICES IN | = H 
| | SYSTEM H 
1 { 1 ' 
t { ! t 
44 { NO QUEUE ENTRY FOUND |} = i 
4 r] ! i] 
' ( { ! 
i 45 i NO GROUP DEFAULT H 7 H 
i i ESTABLISHED t 
] 1 { { 
1 t i] { 
i 46 | VERIFY COMPLETED ON i name of device H 
I ‘] { i] 
I (] i { 
| 66 | SECONDARY AUTHORITY i - i 
H | REJECTED { H 
i 1 H 
{ 67 i INVALID FILE NAME: i name of invalid file | 
{ t { ‘ 
{ t I { 
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TABLE D-1 EXCEPTION MESSAGE ERROR CODES, MESSAGE TEXT, AND 
MESSAGE RELATED DATA SUMMARY (Continued) 


(DECIMAL) {| MESSAGE TEXT | MESSAGE RELATED DATA 


| | 
H 68 { NO DEVICES INCLUDED H i 
j t $ ‘ 
' j ' { 
69 i SPL/32 OS SUPPORT NOT |} = i 
{ i INCLUDED H 
70 | PLEASE CONTINUE = 
71 | NO SECONDARY AUTHORI- | - i 
1 {| ZATION 
| 
{ 72 | NO FILES TO BE = 
} PRINTED ! 
| 
H 73 | INVALID BANNER/ } invalid parameter H 
| | TRAILER PARAMETER: H 
i 74 | INVALID COPIES: | invalid # of copies 
75 { NO QUEUE ENTRIES, NO jj} 


DEVICES 


AR i re ee er rica tae tiartetianes temtalantienae tin tmatsetiantitaainendiataedbemntteetnadlinen i atetened 


D.4.5 Attention Messages 


There are two types of attention messages: 


@e sSVCl and 7 error messages 


@e General attention messages 


The format of the SVC error messages is presented in Figure D-24. 
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4054 0 (00) 
MESSAGE BUFFER FOR SVC6 SEND DATA ; 


MESSAGE HEADER 


48 


RESERVED 


SVC PARAMETER BLOCK 


108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 


148 (94) 
RESERVED 


172 (AC) 
176 (BO) 


180 (B4) 
MESSAGE TEXT 


192 (CO) 
196 (C4) 
200 (CB) 
204 (CC) FILE DESCRIPTOR 


212 (D4) 
216 (D8) 


ERROR TEXT 


252 (FC) 


Figure D-24 SVCl and 7 Attention Messages Record Format 


48-056 FOO ROO 


Fields: 


OID 


MESSAGE SUBTYPE CODE 


FILE DESCRIPTOR 


ERROR TEXT 
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This field is undef ined for 
attention messages. The control 
task must route the message 


according to the AID supplied. 
contains either of the following 
error codes: 

e 1 for SVCl errors 

e 2 for SVC7 errors 


MESSAGE TEXT contains one of the 
following error descriptions: 


e If the attention code is 1; then 
the message text is: 


I/O ERROR ON 


e If the attention code is 2, then 
the message text is: 


FILE ERROR ON 
contains the name of the file or 
device where the error occurred. 
contains one of the entries 


presented in Table D-2 according to 
the attention code present. 


TABLE D-2 ERROR TEXT FIELD ENTRIES FOR 
SVC1l AND 7 ATTENTION MESSAGES 


Cee ee Ne ee ee 


ATTENTION CODE 1 | ATTENTION CODE 2 


Illegal function Tllegal function 


Device unavailable lu error 


End of medium Volume error 
End of file Name error 
Unrecoverable error File error 
Illegal lu Protect error 
Device Busy Privilege error 
Buffer error 


t 

( 

1 

1 

i] 

| 

t 

{ 

1 

i] 

t 

( 

$ 

t 

4 

( 

t 

i] 

i] 

( 

Recoverable error {| Size error 

H 

| 

' 

| 

i] 

| 

i] 

| 

1 

t 

i] 

i] 

t 

| Assignment error 
i 
I 
i 


The format of the general attention message is presented in 
Figure D-25. 
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4056 
0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 


Figure D-25 
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20 (14) 
24 (18) 
28 (iC) 
32 (20) 
36 (24) 


60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (5C} 
96 (60) 
100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AO) 
164 (A4) 
168 {A8) 
172 (AC) 
176 (BOQ) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4 

232 (E8 

236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
262 (FC) 


MESSAGE HEADER 


OID 


MESSAGE HEADER (CONT.) 


SUBTYPE CODE 


MESSAGE: HEADER (CONT.) 


65(41) 


RESERVED 


MESSAGE TEXT 


MESSAGE RELATED DATA 


General Attention Message Format 


Fields: 


OID 


MESSAGE 


MESSAGE 


MESSAGE 


is not defined for attention 


messages. The contr 
route the message acco 
AID supplied. 


SUBTYPE CODE contains one of the 


TEXT 


RELATED DATA 


printed in Table D-3. 


ol task must. 
rding to the 


error codes 


contains a description of the error. 


The entries for thi 
presented in Table D-3 


s field are 


contains the entry in Table D-3 that 


corresponds with the attention code 
and message text present. 


TABLE D-3 GENERAL ATTENTION MESSAGE 
FIELD ENTRIES 


| ATTENTION | H 
| CODE \ MESSAGE TEXT i MESSAGE DATA } 
pH SSS ES SSeS SP ST SSS RS SSS SSS SSS SSeS SSS Tee Sees | 
i 32 i REQUEST IS PEND- |; form name H 
{| ING FOR FORM: 
‘ i] { { 
i} t t t 
| 37 {| MISSING CONTROL |; device name |} 
H i CARD: i H 
H 38 {| INVALID CONTROL | device name { 
1 ! t ! 
1 { 1 i] 


CARD: 


D.4.6 Mnemonic Message Format 


Mnemonic 


messages use the same buffer structure and chain 
structure as previously described in Section D.4.2.2. The format 
of a mnemonic message is presented in Figure D-26. 
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a | 0 (00) MESSAGE BUFFER FOR SVC6 SEND DATA | 
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20 
24 
28 
32 
36 
40 
44 
48 
52 
56 
60 
64 
68 
72 
76 
80 
84 
88 
92 
96 


(14) 
(18) 
(1C) 
(20) 
(24) 
(28) 
(2C) 
(30) 


MESSAGE TYPE 
(34) Ta 


(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AQ) 
164 (A4) 
168 (A8) 


172 (AC) 


176 (BO) 
180 (B4) 
184 (B8) 


188 (BC) 


192 (COQ) 
196 (C4) 
200 (C8) 


204 (CC) 


208 (DO) 
212 (D4) 
216 (D8) 


220 (DC) 


224 (E0) 
228 (E4) 


232 (E8) 


236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure 


MESSAGE HEADER 


MNEMONIC 


TABLE 


OF 


SPL/32 


COMMANDS 


D-26 Mnemonic Message 


Format 


D-65 


Fields: 
MESSAGE TYPE ID 
SVC2 SCAN MNEMONIC TABI.E 


D.4.7 Authority Message Format 


contains an xX'14' to 
mnemonic message. 


identify a 


contains all the valid command 
mnemonics for the spooler. SVC2 
SCAN uses this table to check for 


valid spooler commands. 


The format of an authority message is presented in Figure D-27. 
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4057 0 (00) 
| MESSAGE BUFFER FOR SVC6 SEND DATA | 
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20 
24 
28 
32 
36 
40 
44 
48 


96 


(14) 
(18) 
(1c) 
(20) 
(24) 
(28) 
(2C) 
(30) 
(34) 
(38) 
(3C) 
(40) 
(44) 
(48) 
(4C) 
(50) 
(54) 
(58) 
(5C) 
(60) 


100 (64) 
104 (68) 
108 (6C) 
112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AQ) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (C8) 
204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (£8) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 


Figure 


MESSAGE HEADER 


MESSAGE 53(36) MESSAGE j 54(36) 55(37) 
YPE JD SUBTYPE CODE 


RESERVED 


BLANKS 


NEW AID 


PSEUDO DEVICE NAME 


BLANKS 


D-27 Authority Message Format 


Fields: 


MESSAGE TYPE ID 


MESSAGE SUBTYPE CODE 


NEW AID 


PSEUDO DEVICE NAME 


contains an X'15' to identify the 
authority message. 


contains one of the following 


settings, based on the function of 
the message: 


e 1 = Primary AID approval request 


e 2 = Secondary AID approval request 
e 3 = Authority change accepted 
@e 4 = Authority change rejected 


is the new authorization identifier 
to be accepted or rejected. 


if the message subtype code field is 
set to 2, this field contains’ the 
name of the pseudo device that the 
new AID applies to. 


D.5 MESSAGE RECOVERY PROCEDURES 


If a message from SPL/32 to a control or subcontrol task fails to 
reach its destination, SPL/32 attempts recovery depending on the 
status returned by the SVC6 Send Data function. The error status 
and recovery procedures of SPL/32 are listed in Table D-4. 
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TABLE D-4 SPL/32 ERROR STATUS AND RECOVERY INFORMATION 


Co I ie aetna eee eee Retentann tian camels tet ttieetaenetiaieettian nti tmat tee annette 


STATUS | RECOVERY PROCEDURE 

X'O4' | Messages are rerouted to the appropriate control 
{| origin when communication with a secondary or 

| primary location is lost. When a secondary 

| location is lost, messages are rerouted to the 

{ monitoring control task. When the primary loca- 
i tion is lost, messages are rerouted to the 

i default control task and location, .SPL and the 

i system console, respectively. 
§ 


i 
H 
H 
{ 
1 
i 
H The send is retried five times at 5 second 

{ intervals. If communication fails all five 

\ times, the last error is handled as if an error 
} status X'OB’' was obtained. 

) 

: 


Handled the same as status X'OB'. 


COE ee ne ee en ee dd 
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APPENDIX E 
SPL/32 COMMANDS PREPARSED FORMAT 


E.17 INTRODUCTION 


The preparsed format ‘of the spooler commands is for use _ by 
control tasks that do not use the ASCII form of the commands as 
previously presented in Chapter 6. 


Preparsed spooler commands are passed to the spooler through the 
uniform spooler control interface (USCI). The SVC6 send data 
format for preparsed commands consists of an SVC6 header, a 
message header, and a record containing the command in its 
preparsed form. The format for SVC6 and message headers is 
identical to that used to pass ASCII commands to the spooler. A 
command is designated as preparsed by setting byte 54 of the 
message header to the desired command identifier. This byte is 
set to zero when using the ASCII command format. Byte 55 of the 
message header defines the specific function within the command 
(i.e., include, display, or remove). 


In the following sections, the following information is presented 
for each preparsed command: 
@ the command mnemonic, 


e the command-identifier setting for byte 54 of the message 
header, 


e the record format of the parameters associated with the 
command, and 


e the command-function-identifier setting for byte 55 of the 
message header. 


The function of each command and its associated parameters is 
presented in detail in Chapter 6. 


NOTE 


The byte offset within the record fields 
of each command format is the offset into 
the data record, starting at byte 176 of 
the command buffer. Any unused fields 
should be set to nulis (xX‘'O0O00'). 
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E.2 ATTACH COMMAND 


Command mnemonic: ATTACH 


Command identifier (byte 54 of message header): 1 


(command 


function identifier (byte 55 of message header): 


X'03' = to ATTACH physical devices to pseudo device 


Record 


4005 


format: 


0 (00) PSEUDO DEVICE NAME 
4 (04) PHYSICAL DEVICE 1 


| 8 (08) PHYSICAL DEVICE 2 
12 (C) PHYSICAL DEVICE 3 
20 (14) PHYSICAL DEVICE 5 
24 (18) PHYSICAL DEVICE 6 


52 (34) PHYSICAL DEVICE 13 
56 (38) PHYSICAL DEVICE 14 
60 (3C) PHYSICAL DEVICE 15 
64 (40) PHYSICAL DEVICE 16 
68 (44) PHYSICAL DEVICE 17 


72 (48) PHYSICAL DEVICE 18 
76 (4C) PHYSICAL DEVICE 19 


Fields: 

Pseudo device number specifies the pseudo device to which 
the physical devices are 
attached. 

Physical device name specifies the names of the physical 


devices to be attached to 


specified pseudo device. 
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E.3 BANNER COMMAND 
Command mnemonic: BANNER 
Command identifier (byte 54 of message header): 2 


Command function identifier (byte 55 of the message header): 


X'10' = NONE (no banner page) 
X'20' = SINGLE (one banner page) 


X'40' = DOUBLE (two banner pages) 


Record format: 


4006 


0 (00) DEVICE NAME 
4 (04) VOLUME 
‘8 (08) 
42 (C) 
146 (10) EXTENSION 
| 24 (18) 
| 28 (1C) 
| 32 (20) 

36 (24) 
[ 40 (28) 
| 44 (2C) 
[ 48 (30) 
[52 (34) 
[56 (38) 
[ 60 (3C) 

64 (40) 

68 (44) 

72 (48) 

76 (4C) 


FILENAME 


19(18) 
ACCOUNT 


BLANKS 
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E-3 


Fields: 


Device name 


Volume 


Filename 


Extension 


Account 


CHARACTER 


contains the pseudo or physical 
device name to which the BANNER 
command pertains. 


contains the volume name where the 
file containing the banner page 
specifications resides. 


contains the name of the file that 
contains the banner page 
specifications. 


contains the extension for the file 
that contains the banner page 
specifications. 


contains the account number for the 
file that contains the banner page 
specif ications 


is the character with which the 


letters in the banner are _ to be 
formed. 
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E.4 BLOCK COMMAND 
Command mnemonic: BLOCK 
Command identifier (byte 54 of message header): 3 


Command function identifier (byte 55 of message header): 


X'O00' = to display 


X'03' = to specify 


Record format: 


4007 
O (00) 


4 (04) 
8 (08) 
12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


2(02) 
INDEX BLOCKSIZE 


DATA 
BLOCKSIZE 


BLANKS 


Fields: 


Data blocksize contains the number for the default 
data blocksize. 


Index blocksize contains the number for the default 
index blocksize. 
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i] 
in 


E.5 CHANGE COMMAND 
Command mnemonic: CHANGE 
Command identifier (byte 54 of message header): 4 


Command function identifier (byte 55 of message header): 
X'O3' = change 


Record format: 


4008 
O (00) VOLUME 


4 (04) 
8 (08) FILENAME 


15(F 
12 (C) EXTENSION 


RESERVED 
20 (14) 
24 (18) FORMNAME 


28 (1C) RESERVED 
32 (20) PSEUDO DEVICE 


36 (24) OPTIONS 


40 (28) COPIES 
44 (2C) PRIORITY 
48 (30) 
52 (34) 
56 (38) 
[ 60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Fields: 

Volume contains the volume name of the file 
to be changed. 

Filename contains the name of the file to be 
changed. 

Extension contains the name extension of the 


file to be changed. 
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Account 


Formname 


Pseudo device 


Options 


Number of copies 


Priority 
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contains the account number of the 
file to be changed. 


contains the name of a new form to 
be used for output. 


contains the name of a new pseudo 
device to which the file is to be 
directed. 


This field will remain blank if 
there is no change to the pseudo 
device. 


contains one or a combination of the 
following settings to indicate the 
options in effect: 


Y'O0000' No change 

Y'OO0O1' VFC (if NOVFC set) 

¥'OO002' NOVFC (if VFC set) 

Y'0004' IMAGE (if NOIMAGE set) 

Y¥'OO008' NOIMAGE (if IMAGE set) 

Y¥'O0010' DELETE (if NODELETE set) 

¥'0020' NODELETE (if DELETE set) 

¥'OO040' CHECKPOINT (if NOCHECKPOINT 
set) 

¥'OO80' NOCHECKPOINT (if CHECKPOINT 
set) 

Y'O100' HOLD (if RELEASE set) 

Y¥'O200' RELEASE (if HOLD set) 


contains a new value for the number 
of copies of the file to be output. 


This field will contain zeros if 
there is no change in the number of 
copies. 


contains a new value for the output 
priority of the file to be output. 


This field will contain 1s if there 
is no change in the output priority 
of the file. 


E.6 CHECKPOINT COMMAND 
Command mnemonic: CHECKPOINT 
Command identifier (byte 54 of message header): 5 


Command function identifier (byte 55) of message header): 


X'00' = to display 
X'O1' = CHECKPOINTING on 
X'O2' = CHECKPOINTING off 


Record format: 


4009 


O (00) CHECKPOINT VALUE 


4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) RESERVED 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Fields: 

Checkpoint value contains the value for the number of 
records output between 
checkpointing. 
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E.7 CREATE COMMAND 


Command mnemonic: CREATE 


Command identifier (byte 54 of message header): 


Command function identifer (byte 55 of message header): 


X'03' = to specify new pseudo devices 


Record format: 


4010 Ff 
0 (00) 


4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
"36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
BG (38) 
“60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Fields: 


Pseudo device number 
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PSEUDO DEVICE 1 
PSEUDO DEVICE 2 
PSEUDO DEVICE 3 
PSEUDO DEVICE 4 
PSEUDO DEVICE 5 
PSEUDO DEVICE 6 
PSEUDO DEVICE 7 
PSEUDO DEVICE 8 
PSEUDO DEVICE 9 
PSEUDO DEVICE 10 
PSEUDO DEVICE 11 
PSEUDO DEVICE 12 
PSEUDO DEVICE 13 
PSEUDO DEVICE 14 
PSEUDO DEVICE 15 
PSEUDO DEVICE 16 


~ PSEUDO DEVICE 17 


PSEUDO DEVICE 18 
PSEUDO DEVICE 19 
PSEUDO DEVICE 20 


6 


contains the name of a pseudo device 


to be created. 


E.8 CTASK COMMAND 
Command mnemonic: CTASK 
Command identifier (byte 54 of message header): 7 


Command function identifier (byte 55 in message header): 


X'OO' = to display 
X'OlL' = to include 
X'O2' = to remove 


Record format: 


4011 


CONTROL TASK 1 


CONTROL TASK 2 


16 (10) 
CONTROL TASK 3 


24 (18) 
28 (1C) CONTROL TASK 4 


32 (20) 
36 (24) CONTROL TASK 5 


40 (28) 
44 (20) CONTROL TASK 6 


48 (30) 
52 (34) CONTROL TASK 7 


60 (3C) CONTROL TASK 8 


64 (40) 
68 (44) CONTROL TASK 9 
72 (48) 


76 (4C) CONTROL TASK 10 


Fields: 


Control task number contains the name of a control task 
being included or removed from the 
spooling environment. 
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E.9 DELETE COMMAND 


Command mnemonic: 


Command identifier (byte 54 of message header): 


DELETE 


22(16) 


Command function identifier (byte 55 of message header): 


X'03' = to REMOVE 


Record format: 


4026 


Fields: 


0 (00) 
(04) 
(08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Device number 
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DEVICE 1 
DEVICE 2 
DEVICE 3 
DEVICE 4 
DEVICE 5 
DEVICE 6 
DEVICE 7 
DEVICE 8 
DEVICE 9 
DEVICE 10 
DEVICE 11 
DEVICE 12 
DEVICE 13 
DEVICE 14 
DEVICE 15 
DEVICE 16 
DEVICE 17 
DEVICE 18 
DEVICE 19 
DEVICE 20 


contains the name 
physical device to be deleted. 


of 


a 


pseudo 


or 


E.10 DETACH COMMAND 
Command mnemonic: DETACH 
Command identifier (byte 54 of message header): 8 


Command function identifier (byte 55 of message header): 


X'O3' = to detach 


Record format: 


4012 
O (00) PSEUDO DEVICE NAME 


4 (04) PHYSICAL DEVICE 1 


52 (34) PHYSICAL DEVICE 13 
56 (38) PHYSICAL DEVICE 14 


Fields: 

Pseudo device number contains the name of a pseudo device 
to be detached. 

Physical device number contains the name of a physical 


device to be detached. 
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E.11 DEVICE COMMAND 


Command mnemonic: 


DEVICE 


Command identifier (byte 54 of message header): 9 


Command function identifier (byte 55 of message header): 


X'10' = 
X'1ll' = 
X'20' = 
X'21' = 
X'22' = 


to 
to 
to 
to 


to 


Record format: 


4013 


0 (00) 
4 (04) 
8 (08) 
12 (C) 


16 (10) 


20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
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forward space line X'30' = FREE 
forward space page X'31' = RESTRICT 
backward space line X'40' = SUSPEND IMMEDIATE 
backward space page X'41' = SUSPEND DELAYED 
rewind X'50' = CONTINUE 

DEVICE NAME 


NUMBER OF LINES OR PAGES 


BLANKS 


Fields: 


Device name 


Number of pages/lines 


BE-14 


contains the name of a pseudo or 
physical device. 


contains the number of Lines or 


pages to be spaced according to the 
function id. 
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E.12 END COMMANDO 
Command mnemonic: END 
Command identifier (byte 54 of message header): 21(15) 


Record format: 


The Data Record is not used for this command. 


Command function identifier (byte 55 of message header): 


X'O1' = IMMEDIATE 


X'O02' = DELAYED 
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E.13 FLUSH COMMAND 
Command mnemonic: FLUSH 
Command identifier (byte 54 of message header): 10(A) 


Command function identifier (byte 55 of message header): 


X'10' = FLUSH fd 
X'1l1' = FLUSH fd, DELETE 
X'20' = FLUSH dev: 


Record format: 


4014 
0 (00) VOLUME 


4 (04) 
8 (08) 


12 (C) EXTENSION ACCOUNT 


16 (10) DEVICE 
20 (14) 7 


24 (18) 


FILENAME 


28 (1C) 
32 (20) 
36 (24) 


40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


BLANKS 
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Fields: 


Volume 


Filename 


Extension 


Account 


Device 
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contains the volume name for the 
file to be flushed. 


contains the name of the file to be 
flushed. 


contains the filename extension for 
the file to be flushed. 


contains the account number of the 
file to be flushed. 


contains the name of the device to 
be halted. 


E.14 FORM COMMAND CINCLUDE) 
Command mnemonic: FORM (INCLUDE) 
Command identifier (byte 54 of message header): 11(B) 


Command function identifier (byte 55 of message header): 
X'O1L' = include 
Record format: 


4015 


FORMNAME 1 


16 (10) PAGE LENGTH 1 TOP MARGIN 1 BOTTOM MARGIN 1{ PAGE WIDTH 1 


20 (14) 


24 (18) 
FORMNAME 2 


32 (20) 


36 (24) PAGE LENGTH 2 TOP MARGIN 2 BOTTOM MARGIN 21] PAGE WIDTH 2 


44 (2C) 
48 (30) 


56 (38) PAGE LENGTH 3 TOP MARGIN3 |BOTTOM MARGIN 3] PAGE WIDTH 3 


60 (3C) 
64 (40) 


FORMNAME 3 


FORMNAME 4 


72 (48) 


76 (4C) PAGE LENGTH 4 TOP MARGIN4 | BOTTOM MARGIN 4] PAGE WIDTH 4 


E-18 48-056 FOO ROO 


Fields: 


Formname 


Page length 


Top margin 


Bottom margin 


Page width 
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contains the names of forms to be 
included in the spooler environment. 


contains default page lengths for 
the associated form. 


contains the top margin length for 
the associated form. 


contains the bottom margin length 
for the associated form. 


contains the horizontal page size 
for the associated form. 


E.15 FORM COMMAND (CREMOVE) 
Command mnemonic: FORM (REMOVE) 
Command identifier (byte 54 of message neader): 11(B) 


Command function identifier (byte 55 of message header): 
X'O2' = to REMOVE 


Record format: 


4063 

O (00) 
4 (04) 
8 (08) 
12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 


FORMNAME 1 


FORMNAME 2 


44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


FORMNAME 4 


FORMNAME 5 


Fields: 

FORMNAME N contains the name of a form to _ be 
removed from the spooler 
environment. 
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E.16 FORM COMMAND (MOUNT. MOUNT VERIFY) 
Command mnemonic: FORM (MOUNT, MOUNT/VERIFY) 
Command identifier (byte 54 of message header): 11(B) 


Command function identifier (byte 55 of message header): 


X'OO' = to display 
X'04' = MOUNT 
X'14° = MOUNT/VERIFY 


Record format: 


4016 


0 (00) 
4 (04) 
S108) FORMNAME 
12 (C) 
16 (10) DEVICE 1 
20 (14) DEVICE 2 
24 (18) DEVICE 3 
DEVICE 4 
32 (20) DEVICE 5 
36 (24) DEVICE 6 
40 (28) DEVICE 7 
44 (2C) DEVICE 8 
48 (30) DEVICE 9 
52 (34) DEVICE 10 
56 (38) DEVICE 11 
60 (3C) DEVICE 12 
64 (40) DEVICE 13 
68 (44) DEVICE 14 
72 (48) DEVICE 15 
76 (4C) NUMBER OF PAGES 
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Fields: 


Formname 


Device n 


Number of pages 


contains the name of the form 
mounted on the specified devices. 


contains the name of the devices’ to 
have the specified formname mounted. 


specifies the number of pages to be 
output for alignment verification. 
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E.17 QLOBAL COMMANDO 
Command mnemonic: GLOBAL 
Command identifier (byte 54 of message header): 12(C) 


Command function identifier (byte 55 of message header): 


X'00' = to display 


X'03' = to specify 


Record format: 


4017 


O (00) PSEUDO DEVICE NAME 
4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
“| 60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


BLANKS 


Field: 


Pseudo device name contains the name of the global 
pseudo device. 
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E.18 GROUP COMMAND 
Command mnemonic: GROUP 
Command identifier (byte 54 of message header): 13(D) 


Command function identifier (byte 55 of message header): 


X'OO' = to display 
X'O1' = INCLUDE 
X'O2' = REMOVE 


Record format: 


4018 
PSEUDO DEVICE NAME 


UNIT ID 1 


12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) BLANKS 


UNIT 1D 2 


UNIT ID 3 


UNIT ID 4 


UNIT ID 5 


UNIT ID 6 


UNIT ID 7 


UNIT 1D 8 


UNIT ID9 


Fields: 

Pseudo device name contains the name of the default 
pseudo device for the group. 

Unit ID n contains terminal or task 


identifiers. 
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E.19 INPUT COMMAND CINCLUDE) 


Command mnemonic: 


INPUT 


Command identifier (byte 54 of message header): 14(E) 


Command function identifier (byte 55 of message header): 


X'O1' = INCLUDE 


Record format: 


4019 
0 (00) 


4 (04) 
8 (08) 
12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Fields: 


Control task 


Device number 
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CONTROL TASK 


_ DEVICE 1 
DEVICE 2 
DEVICE 3 
DEVICE 4 
DEVICE 5 
DEVICE 6 

_ DEVICE 7 
DEVICE 8 
DEVICE 9 
DEVICE 10 
DEVICE 11 
DEVICE 12 

__DEVICE 13 
DEVICE 14 
DEVICE 15 

~ DEVICE 16 
DEVICE 17 
DEVICE 18 


contains the name of the control 
task that will monitor the specified 
input devices. 


contains the names of the _ physical 
devices assigned to input spooling. 


E. 20 


INPUT COMMAND CREMOVE) 


Command mnemonic: INPUT 


Command identifier (byte 54 of message header): 14(E) 


Command function identifier (byte 55 of message header): 


X'O02' = to REMOVE 


Record format: 


4062 


20 (14) DEVICE 6 
24 (18) DEVICE 7 
28 (1C) DEVICE 8 
32 (20) DEVICE 9 


68 (44) DEVICE 18 
72 (48) DEVICE 19 


76 (4C) DEVICE 20 


Fields: 


Device n 


to be removed from the 
environment. 


48-056 


contains the name of an input device 


spooling 


FOO ROO 


E.21 INTERROGATE COMMAND 
Command mnemonic: INTERROGATE 
Command identifier (byte 54 of message header): 15(F) 


Command function identifier (byte 55 of the message header): 


QUEUE 


X'10' = 

X'11' = QUEUE pd: 
X'12' = QUEUE form 
X'13' = QUEUE fd: 
X'20' = CONFIGURATION 


Record format: 


4020 
0 (00) VOLUME 1 


4 (04) 
8 (08) 


12 (C) EXTENSION 1 ACCOUNT 1 


16 (10) VOLUME 2 
20 (14) 


24 (18) FILENAME 2 


28 (1C) ~~ EXTENSION 2 ACCOUNT 2 


32 (20) PSEUDO DEVICE 
36 (24) 


40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


FILENAME 1 
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Fields: 


Volume 1 


Filename lL 


Extension 1 


Account 1 


Volume 2 


Filename 2 


Extension 2 


Account 2 


Pseudo device 


contains the volume name of the file 
for which information is to be 
displayed. 


contains the name of the file for 
which information is to be 
displayed. 


contains the name extension of the 
file for which information is to be 
displayed. 


contains the account number of the 
file for which information is to be 
displayed. 


contains the volume name of the file 
for the formname to be displayed. 


contains the name of a form about 
which information is to be 
displayed. 


contains the name extension of the 
file with the formname information. 


contains the account number of the 
file with the formname information. 


contains the name of a pseudo device 


about which information is to be 
displayed. 
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E.22 PRIMARY COMMAND 
Command mnemonic: PRIMARY | 
Command identifier (byte 54 of message header): 16(10) 


Command function identifier (byte 54 of message header): 


X'00' 


to display 


Xx'0O3' to specify 


Record format: 


4061 


0 (00) 
4 (04) 
8 (08) 
12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 


CONTROL TASKNAME 


AUTHORIZATION IDENTIFIER (AID) 


44 (2C) BLANKS 
48 (30) 


52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


Fields: 


Control taskname contains the name of a control task. 


Authorization Identifier contains the primary authorization 
(AID) identifier. 
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E.23 PRINT COMMAND 


Command mnemonic: PRINT 


Command identifier (byte 54 of memory header): 17(11) 


Command function identifier (byte 55 of message header): 


X'O3' = PRINT 


Record format: 


4022 


O (00) VOLUME 


4 (04) 


FILENAME 


8 (08) 
12 (C) EXTENSION 1 et F COUNT 
16 (10) RESERVED 


20 (14) 
24 (18) 
28 (1C) RESERVED 


FORMNAME 


56 (38) 
60 (3C) 
64 (40) 


BLANKS 


72 (48) 
76 (4C) 


Fields: 

Volume contains the volume name 
file to be printed. 

Filename contains the name of the file to 
printed. 

Extension contains the extension of the 
to be printed. 
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Account 


Formname 


Pseudo device 


Options 


Number of copies 


Priority 
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contains the account number of the 
file to be printed. 


contains the name of the form 
required for output. 


contains the name of the _ pseudo 
device the output is to be directed 
to. 


contains one or a combination of the 
following settings: 


Y¥'OQOO1L' = VFC (if NOVFC set) 

¥'Q0002' = NOVFC (if VFC set) 

¥'0004' = IMAGE (if NOIMAGE set) 

Y¥'O008' = NOIMAGE (if IMAGE set) 

Y¥'OO10' = DELETE (if NODELETE set) 

¥'OO20' = NODELETE (if DELETE set) 

¥'0040' = CHECKPOINT (if NOCHECKPOINT 
set) 

¥'OO80' = NOCHECKPOINT (if CHECKPOINT 
set) 

¥'0O100' = HOLD (if RELEASE set) 

Y¥'O200' = RELEASE (if HOLD set) 


contains the number of copies to be 
printed. ; 


contains the output priority of the 
file to be printed. 


E.24 PRIORITY COMMAND 
Command mnemonic: PRIORITY 
Command identifier (byte 54 of message header): 18(12) 


Command function identifier (byte 55 of the message header): 


X*0OO' to display 


X'03' 


to specify 


Record format: 


4023 


O (00) PRIORITY 


4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 


BLANKS 


Fields: 


Priority contains the default priority value. 
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E.25 PUNCH COMMANDO 
Command mnemonic: PUNCH 


Command identifier (byte 54 of message header): 19(13) 


Command function identifier (byte 55 of message header): 
X'03' = PUNCH 


Record format: 


4024 fo (00) VOLUME NAME 


4 (04) 

106) FILENAME 

12 (C) EXTENSION 
16 (10) RESERVED 

20 (14) 

34 (18) FORMNAME 
28 (1C) | RESERVED 

32 (20) PSEUDO DEVICE 
36 (24) OPTIONS 

40 (28) NUMBER OF COPIES 
44 (2C) PRIORITY 

48 (30) 

52 (34) 

56 (38) BLANKS 

60 (3C) 

64 (40) 

68 (44) 

72 (48) 

76 (4C) 
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Fields: 


Volume contains the volume name for the 
file to be punched. 


Filename contains the name of file to be 
punched. 
Extension contains the filename extension of 


the file to be punched. 


Account contains the account number of the 
file to be punched. 


Formname contains the name of the preprinted 
card required for output. 

Pseudo device contains the name of the _ pseudo 
device the output is to be directed 
to. 

Options contains one or a combination of the 


following settings: 


Y'OOO1L' = VFC (if NOVFC set) 
Y¥'OO02' = NOVFC (if VFC set) 
Y'0004' = IMAGE (if NOIMAGE set) 
Y'OO0O08' = NOIMAGE (if IMAGE set) 
Y¥'OO10° = DELETE (if NODELETE set) 
Y¥'0020' = NODELETE (if DELETE set) 
Y¥'O0040° = CHECKPOINT (if NOCHECKPOINT 
set) 
Y¥'OO80' = NOCHECKPOINT (if CHECKPOINT 
set) 
Y¥'O100' = HOLD (if RELEASE set) 
Y¥'O200' = RELEASE (if HOLD set) 
Number of Copies contains the number of copies to be 
punched. 
Priority contains the output priority of the 


file to be punched. 
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E.26 QUEUE COMMAND 


Command mnemonic: QUEUE 


Command identifier (byte 54 of message header): 


Command function identifier (byte 55 of the message header): 


x'OO0' 


to display 


X'03' = to specify 


Record format: 
4025 
0 (00) 
4 (04) 
8 (08) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
48 (30) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
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20(14) 


VOLUME 


FILENAME 


15(F) 
ACCOUNT 


EXTENSION 


BLANKS 


Fields: 


Volume 


Filename 


Extension 


Account 


contains the volume name for the 
spool queue file. 


contains the name of the file to be 
the queue file. 


contains the file name extension for 
the spool queue file. 


contains the account number for the 
spool queue file. 
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E.27 SCTASK COMMAND 
Command mnemonic: SCTASK 
Command identifier (byte 54 of message header): 24(18) 


Command function identifier (byte 55 of message header): 


X'00' = to display 
X'O1l' = to INCLUDE 
X'02' = to REMOVE 


Record format: 


4027 


QO (00) 
CONTROL TASK 

a (04) 
8 (08) 

SUBCONTROL TASK 1 
12 (C) 
16 (10) 

SUBCONTROL TASK 2 
20 (14) cone 
24 (18) 

SUBCONTROL TASK 3 
28 (1C) 
32 (20) 

BCONTROL TASK 4 

36 (24) SU TROL T 
40 (28) 
44 (20) SUBCONTROL TASK 5 
48 (30) 
52 (34) SUBCONTROL TASK 6 
56 (38) 

SUBCONTROL TASK 7 
60 (aC) 4 
64 (40) 
68 (44) SUBCONTROL TASK 8 
72 (48) 
76 (4c) SUBCONTROL TASK 9 
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Fields: 


Control task contains the name of the control 
task associated with the specified 
subcontrol tasks. 


Subcontrol task contains the name of the  subcontrol 
tasks. 
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E.28 SECONDARY COMMAND 
Command mnemonic: SECONDARY 
Command identifier (byte 54 in message header): 23(17) 


Command function identifier (byte 55 of message header): 


X'OO' 


to display 


X'03' 


| 


to specify 


Record format: 


4028 


0 (00) 
4 (04) 
8 (08) PSEUDO DEVICE 
12 (C) 
16 (10) AUTHORIZATION IDENTIFIER 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24), 
40 (28) 
44 (2C) 
48 (30) BLANKS 
52 (34) | 
56 (38) 
60 (3C) 
64 (40) 
68 (44) 
72 (48) 
"76 (4C) 


TASKNAME 


Fields: 


Taskname contains the name of a control task. 


Pseudo device contains the name of the default 
pseudo device. 


Authorization Identifier contains the secondary authorization 
identifier. 
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E.29 SPVOLUME COMMAND 
Command mnemonic: SPVOLUME 
Command identifier (byte 54 of message header): 25(19) 


Command function identifier (byte 55 of message header): 


X'O00' = to display 
X'O1' = INCLUDE 
X'O2' = REMOVE 


Record format: 
fo (00) VOLUME 1 
4 (04) VOLUME 2 
8 (08) VOLUME 3 
12 (C) VOLUME 4 
16 (10) - VOLUME 5 
20 (14) VOLUME 6 
24 (18) VOLUME 7 


28 (1C) VOLUME 8 
32 (20) VOLUME 9 


Fields: 

Volume contains the name of volumes to be 
included Or removed as spool 
volumes. 
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E.30 TRAILER COMMANDO 
Command mnemonic: TRAILER 
Command identifier (byte 54 of message header): 26(1A) 


Command function identifier (byte 55 of message header): 


X'10' = NONE 
X'20' = SINGLE 
X'40' = DOUBLE 


Record format: 


4030 
0 (00) DEVICE 


4 (04) VOLUME 


8 (08) 
12 (c) FILENAME 


19(13 
EXTENSION ACCOUNT 


16 (10) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) BLANKS 
44 (2C) 

48 (30) 

52 (34) 

56 (38) 

60 (3C) 

64 (40) 

68 (44) 

72 (48) 

76 (4C) 
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Fields: 


Device 


Volume 


Filename 


Extension 


Account 


Character 


contains the name of the pseudo or 
physical device to which the TRAILER 
command pertains. 


contains the volume name of the file 
that contains the trailer page 
specifications. 


contains the name of the file that 
contains the trailer page 
specifications. 


contains the filename extension of 
the file that contains the trailer 
page specifications. 


contains the account number for the 
file that contains the trailer page 
specifications. 


contains the character with which 


the letters of the trailer page are 
to be formec. 
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E.31 SUMMARY 


Table E-1l provides a summary of preparsed command information. 


TABLE E-1 SUMMARY OF COMMAND IDENTIFIERS (BYTE 54) 
AND COMMAND FUNCTION IDENTIFIERS (BYTE 55) 
FOR PREPARSED COMMANDS 


ee ee en ene ee 


COMMAND H 
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ATTACH 


BANNER 


BLOCK 


CHANGE 


CHECKPOINT 


CREATE 


CTASK 


DELETE 


DETACH 


DEVICE 


END 


FLUSH 
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COMMAND 
IDENTIFIER 


(hexadecimal) 
1 
2 


15 


me eee we we we me wee we we oe oe oe we we we we Oe ow Oe oe Oe we Oe we Oe ee ee Se Se ee ee ee ee we ew eee ee ee eer 


FUNCTION 
IDENTIFIER 


(hexadecimal) 


. SSIS SSR EREVSESKEAAKEAKLBBEESI SPREALRBERBESEVEKBSVES BHT SS SS SKE SCHKsTes lS SSSI CS KCK SSeS eS fz se 


FUNCTION 


To specify 


No banner page 
Single banner page 
Double banner page 


To display 
To specify 


To specify 


To display 
Turn on 
Turn off 


To specify 


To display 
To INCLUDE 
To REMOVE 
TO SPECIFY 
To detach 


Forward space line 
Forward space page 
Backward space line 
Backward space page 
Rewind 

Free 

Restrict 

SUSPEND immediate 
SUSPEND delayed 
Cont inue 


IMMEDIATE 
DELAYED 


Flush fa 
Flush fd, DELETE 
Flush dev 


wee eee eee ee ew ww we we ow we we Ow we we we we we em ee ew ee ee ee we ee om ee Rn we wn ee et ee ee See er eer er sr ser ws er eee 
— — 


COMMAND 


i i i 
COMMAND { COMMAND H FUNCTION H 
MNEMON IC i IDENTIFIER H IDENTIFIER | FUNCTION 
i i 
FORM H B H 0 | To display 
i { 1 {| INCLUDE 
| 2 | REMOVE 
| 4 i MOUNT 
H H 14 {| MOUNT VERIFY 
i 
GLOBAL | Cc i 0 | To display 
| { 3 i To specify 
i 
GROUP H D | 0 i To display 
i | 1 {| INCLUDE 
| 2 | REMOVE 
1 
INPUT | E | 0 { To display 
H 1 {| INCLUDE 
{ | 2 {| REMOVE 
i 1 
INTERROGATE | F | 10 {| QUEUE 
| 11 | PD 
i i 12 | FORM 
| 13 { FD 
{ | 20 { Configuration 
i i i 
PRIMARY H 10 { 0 { To display 
H { 3 | To specify 
PRINT H 11 { 3 i To print 
i 
PRIORITY | 12 i 0 i To display 
H | 3 { To specify 
PUNCH { 13 | 3 {| To punch 
i { | 
QUEUE | 14 | 0 i To display 
3 | To specify 
i 
SCTASK H 18 | 0 i To display 
1 i 1 { To INCLUDE 
i | 2 {| To REMOVE 
SECONDARY | 17 i 0 | To display 
| 3 | To specify 
i i 
SPVOLUME H 19 | 0 i To display 
i i 1 | To INCLUDE 
i H 2 {| To REMOVE 
! i] ' 
t t { 
TRAILER i 1A H 10 | No trailer page 
| i 20 i Single trailer page 
i 40 | Double trailer page 
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INDEX 


CTASK command 


! 
U 


preparsed format 
service record format 


OM MW Ww W& 
t ! 
Nee PP Pb 


preparsed format 
service record format 


OMMAMWNNAHA FHA 
| 
NOVDNOF WNP NRE 


ho 


/®INPUT control statement 2-1 i c 
/@SUBMIT control statement 2-3 H 
A | CHANGE command 4-5 
i 4-17 
Acceptance messages i S29 
function of SZ H 6-8 
Acceptance response message H preparsed format E-6 
format D-10 | CHECKPOINT command 4-14 
AID. See authorization H 6-10 
identifier. H preparsed format E-8 
ASSIGN command 3-1 | service record format D-24 
ATTACH command 4-4 } CHECKPOINT feature 
4-8 { turning off 4-15 
6-2 H use of 4-14 
preparsed format E-2 ; Command comparison 
service record format D-20 } SPL/32 vs. OS/32 Spooler c-1 
Attention messages D-59 ; Command messages 5-5 
function of 5#3 H D-8 
SVCl and 7 D-61 | function of §=2 
types of D-59 {| Command summary A-1 
Authority message format D-65 j; Communication with a task 
Authority messages H losing D-2 
function of S-3 H terminating D-2 
Authorization identifiers i Communication with spooler 
function of 5-10 |} establishing D-2 
primary AID 5-10 }; Console interface 
secondary AID 5-10 | conventions 1-12 
Authorization levels {| Control tasks 5=1 
associated spooler ! communication with the 
commands 5-9 i spooler a*2 
definition of L-6 H definition of 1-6 
function of 5-8 1 displaying 5-4 
primary 1-6 ' function 5=2 
5-1 H in the spooling 
relation to task types 5-1 H environment 5-4 
secondary 1-6 H message types S=2 
5=1 H normal termination of D-2 
user 1-6 H removing 5-4 
5-1 } spooler communication 
' with 5-3 
| CREATE command 6-12 
B i preparsed format E-9 
; Creating pseudo devices 
BANNER command -14 =} explicitly 4-3 
= i implicitly 4-3 
preparsed format “= | Creating the spool queue 
BANNER pages ' example 7 
contents of oo! ac explicitly = 
BLOCK command = ! implicitly = 
: 
4 
! 
i D 
1 
| DELETE command 4-7 
' 6-15 
i preparsed format E-11 
1 
1 
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DETACH command 


preparsed format 
DEVICE command 


preparsed format 
Device contention 
Dialogue termination 
Displaying queue entries 
according to preprinted 
form requests 
by assigned pseudo device 
by particular file 
displaying all 
information 
displaying spooler 
configuration 
Displaying spooler 
environment configurations 


END command 


preparsed format 

End control statement 

Ending a spooler task 

Ending conventions for START 
command file 

Establishing input spooling 
Exception message error codes 
Exception message-message 
related data 

Exception message-message 
test 

Exception response messages 


error codes 
function of 


F 
FLUSH command 


preparsed format 
FORM command 


service record format 
FORM command (INCLUDE) 
preparsed format 
FORM command (MOUNT/MOUNT 
VERIFY) 
preparsed 
FORM command 
preparsed 


format 
(REMOVE ) 
format 


G 
General attention message 


field entries 
GLOBAL command 


IND-2 


bobo 
~ 
No 


(4 


UOrermonrryians 
,t 
WHE KODE 
Ww ~J 
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GLOBAL. command (Continued) 
preparsed format 
service record format 

Global priority 
changing 

Global pseudo device 
definition of 

GROUP command 
preparsed format 
service record format 


H 


Hardware requirements for 
SPL/32 


I,J,K 


I/O device utilization 
Identification pages 
banner pages 
trailer pages 
use of 
Individual command service 
response 
Initializing SPL/32 
INPUT command 


service record format 
INPUT command (INCLUDE) 

preparsed format 
INPUT command (REMOVE) 

preparsed format 
Input spooling 

control statements 

Gefinition of 

ending 

establishing 

introduction 

removing devices 
Input spooling control. 
statements 

/@INPUT 

/@SUBMIT 

ending 

stacking card files 

syntactically incorrect 


INTERROGATE command 
functional discussion of 
preparsed format 
service record format 

Interrogating the spool queue 


L 


Linking SPL/32 
Loading SPL/32 
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E~23 
D-30 
4-16 
4-16 


4-2 

6-27 
E-23 
D-32 
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Memory requirements for Physical devices 


1 
i 
‘ 
i 
SPL/32 1-8 H removing from spooling 
Message formats D-8 { environment 4-10 
acceptance response D-10 ; Preprinted forms 
command message D-8 H associating with a 
request for mnemonic H physical device 4-11 
table D-12 } characterizing 4-11 
service response message D-14 |} naming 4-11 
SPL/32 to task D-14 } removing from spooling 
task to SPL/32 D-8 i environment 4-12 
Message handling ' use of 4-10 
attention messages D-59 |} verify the alignment of 4-12 
authority message format D-65 ; Primary AID 
communication with H function of 5-10 
spooler D-2 | Primary authorization level 5S) 
dialogue termination D-3 H function of 5-8 
exception response i PRIMARY command 5-8 
messages D-54 | 6-33 
general attention H preparsed format E-29 
message field entries D-64 |} service record format D-42 
message formats D-8 H PRINT command 4-5 
message header D-4 i 6-35 
message overview D-1 H preparsed format E-30 
message recovery | Print locations 
procedures D-68 j} establishing unique 
message routing D-3 H defaults 4-6 
mnemonic message format D-64 ; PRIORITY command 4-16 
response routing D-3 ' 6-37 
uniform spooler control H preparsed format E-32 
interface D-1 | service record format D-44 
Message header D-4 | Pseudo devices 4-2 
Message overview D-1 H associating with 
Message recovery procedures D-68 physical devices 4-4 
error status D-69 |} creating 4-3 
recovery information D-69 jj; Gefinition of 1-3 
Message routing D-3 ' 4-2 
Message summary Be1 H deleting from spooling 
Mnemonic message H environment 4-7 
format D-64 j; directing output to 4-5 
Mnemonic messages H Gisassociating from 
function of a { physical devices 4-7 
H limiting default access 
i to 4-6 
oO i optional output 
' parameters 4-5 
OID. See origin identfiers. i PUNCH command 4-5 
Origin identifiers H 6-38 
function of 5-10 | preparsed format E-33 
Output devices i 
altering the status of 4-8 i 
control of 4-8 i Q 
Output priority i 
altering 4-17 {| QUEUE command " 3-4 
assignment of 4-16 |} 6-40 
global priority 4-16 | preparsed format E-35 
user priority 4-16 |} service record format D-46 
Output spooling H 
definition of 1-3 H 
features of 4-1 H R 
global pseudo device 4-2 H 
introduction 4-1 } Request for mnemonic table 
pseudo device 4-2 H messages D-12 
t function of 5-2 
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Response routing SPL/32 commands (Continued) 


' 
t 
spooler to task D-3 H DETACH 6-16 
H DETACH preparsed format E-12 
H DEVICE 6-17 
Ss ' DEVICE preparsed format E-13 
H END 6-20 
SCTASK command 6-42 H END preparsed format E-15 
preparsed format E-37 |} FLUSH 6-21 
service record format D-48 j; FLUSH preparsed format E-16 
Secondary AID H FORM 6-23 
function of 5-10 } FORM preparsed format E-18 
Secondary authorization level 5-1 H GLOBAL 6-26 
function of 5-8 H GLOBAL preparsed format E-23 
SECONDARY command 5-8 H GROUP 6-27 
6-44 | GROUP preparsed format E-24 
preparsed format E-39 jj; INPUT 6-29 
service record format D-50 | INPUT preparsed format E-25 
Service response message H INTERROGATE 6-31 
format H INTERROGATE preparsed 
buffer set D-15 }; format E-27 
individual command H preparsed summary E-43 
service D-20 jj} PRIMARY 6-33 
Service response message H PRIMARY preparsed format E-29 
formats D-14 ; PRINT 6-35 
ATTACH D-20 | PRINT preparsed format E-30 
BLOCK D-22 } PRIORITY 6-37 
CHECKPOINT D-24 |; PRIORITY preparsed format E-32 
CTASK D-26 | PUNCH 6-38 
FORM D-28 } PUNCH preparsed format E-33 
GLOBAL D-30 } QUEUE 6-40 
GROUP D-32 | QUEUE preparsed format E-35 
INPUT D-34 | SCTASK 6-42 
INTERROGATE D-36 |} SCTASK preparsed format E-37 
PRIMARY D-42 } SECONDARY 6-44 
PRIORITY D-44 ; SECONDARY preparsed 
QUEUE D-46 ; format E-39 
SCTASK D-48 |} SPOOLF ILE 6-45 
SECONDARY D-50 | SPVOLUME 6-48 
SPVOLUME D-52 | SPVOLUME preparsed format E-40 
Service response messages 5-5 H summary A-1 
function of aes i TRAILER 6-50 
Software requirements for H TRAILER preparsed format E-41 
SPL/32 1-8 | SPL/32 commands preparsed 
SPL/32 i format 
initialization Leo i FORM (MOUNT/MOUNT VERIFY) E-22 
loading procedures 1-9 I FORM (REMOVE) E-20 
SPL/32 command message ! GLOBAL E-23 
summary B-1 H GROUP E-23 
SPL/32 commands 6-1 H INPUT (INCLUDE) E-25 
ATTACH 6-2 ' INPUT (REMOVE) E-26 
ATTACH preparsed format E=2 H INTERROGATE E-26 
BANNER 6-4 ! PRIMARY E-29 
BANNER preparsed format E-3 H PRINT E-30 
BLOCK 6-7 ' PRIORITY E-32 
BLOCK preparsed format E-5 H PUNCH E-33 
CHANGE 6-8 H QUEUE E-35 
CHANGE preparsed format E-6 H SCTASK Es37 
CHECKPOINT 6-10 |} SECONDARY E-39 
CHECKPOINT preparsed H SPVOLUME E-40 
format E-8 H summary of preparsed 
CREATE 6-12 } commands E-43 
CREATE preparsed format E-9 H TRAILER E-41 
CTASK 6-13 {| SPL/32 requirements 1-8 
CTASK preparsed format E-10 } hardware Ls 
DELETE 6-15 | memory 1-8 
DELETE preparsed format E-1ll } software 1-8 
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SPL/32 to task message 
formats 
service response message 
Spool file 
allocation of 
definition of 


displaying queue entries 
evolution of 
introduction 
naming 
output priority of 
output queue order 
record length of 
specifying data blocksize 
specifying index 
blocksize 

Spool queue 


creating 
default name 
definition of 


displaying 
displaying entries in 
interrogating 
introduction 
removing files from 
respecifying 
Spooler control 
components of 
relationship 
SPOOLFILE command 


Spooling 
definition of 
introduction 

Spooling process 
components of 
definition of 

SPVOLUME command 


preparsed format 
service record format 
Stacking card files 
control statement 
sequences for 
START command 
examples 
format 
START command file 
creating 
ending 
START command file 
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3-1 
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3-2 
4-17 
3-3 
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(Cont inued } 
sample 
Starting spooler 
Subcontrol tasks 
communication with the 
spooler 
definition of 
displaying 
function 
in the spooling 
environment 
removing 
spooler communication 
with 
SVC1l and 7 attention messages 
attention codes 
System performance effects 


T 


Task to SPL/32 message 
formats 
acceptance response 
request for mnemonic 
table 
Tasks 
control 
relation to 
authorization levels 
subcontrol 
types 
user-level 
TRAILER command 


preparsed format 
TRAILER pages 
contents of 


U-Z 


Uniform spooler control 
interface (USCI) 
Gefinition of 
functions of 
USCI. See uniform spooler 
control interface. 
User authorization level 
function of 
User-level tasks 
commands available to 
communication with the 
spooler 
function of 
User priority 
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PERKIN-ELMER 
Technical Systems Division 


DOCUMENTATION CHANGE N O TICE 


The purpose of this documentation change notice (DCN) is to 
provide a quick and efficient way of making technical changes’ to 
manuals before they are formally updated or revised. 

The manual affected by these changes is: 
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@ Page 1-7 


After the last paragraph in Section 1.5.1, please insert: 


NOTE 
At this time, the Perkin-Elmer Network 
(PENnet) and SPL/32 are incompatible. 
Users who want the capabilities of 
PENnet must configure their system 
with OS/32 Spooler support. See the 
0S/32 System Generation/32 (SYSGEN/32) 
Reference Manual. 
@ Page B-l 


Before the first message, please insert the following: 
CANNOT ASSIGN DISPLAY MESSAGE FILE 


The display message file (SPLDISPL.MES) cannot be assigned. 
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| Page B-1 


Immediately after the above inserted message, please insert: 
CORRUPTED QUEUE 


The Spooler cannot read the spool queue because the queue 
entry links have been corrupted. 


Page B-4 


After the sixth message, please insert: 
OS DOES NOT SUPPORT SPL32 


The operating system was configured without support for 
SPL/32. Re-sysgen the operating system to include SPL/32 
support. 


Page D-59 


Message code 69. Please change this message to read: 
OS DOES NOT SUPPORT SPL32 
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After message code 75, please insert the following messages: 


77 CORRUPTED QUEUE 


78 CANNOT ASSIGN DISPLAY MESSAGE FILE 
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